WoalzCraft
Download Plugin

Getting started

Welcome. WoalzCraft is an AI tool that generates Unreal Engine Blueprints from plain English. This page walks you from "what is this" to "I just generated my first Blueprint" in under 10 minutes.

There are two ways to start depending on how you like to learn:

  • Path A — Browse first. Look around the knowledge base to see what kinds of patterns the AI knows. No account, no install, no commitment. Good if you want to evaluate before installing.
  • Path B — Sign up + install. Create an account, install the plugin, and generate your first Blueprint right away. Good if you already know you want to try it.

Both paths are fine. You can also do A first and B later.

What WoalzCraft is — and isn't

Before you commit time, set realistic expectations. WoalzCraft is good at some things, not others. We say this upfront so you don't get frustrated when you hit the edges.

What it is

A Blueprint generation agent for Unreal Engine 5. Strong at:

  • ✅ Generating single Blueprints from natural language
  • ✅ Editing existing Blueprints with follow-up prompts
  • ✅ Multi-Blueprint planning (Chat Agent Mode) — "build me a player + enemy + game mode"
  • ✅ Validating every node before commit, with plain-English error translation
  • ✅ Few-shot retrieval from a curated knowledge base (500+ patterns and growing)
  • ✅ MCP integration so Claude Code, Cursor, Cline, or Gemini CLI can drive the editor

What it isn't (yet)

A complete game-from-prompt tool. WoalzCraft cannot:

  • ❌ Create 3D meshes, textures, materials, audio, or animation clips
  • ❌ Place actors in a level, design terrain, or set up lighting
  • ❌ Generate the project itself, set up Game Mode wiring, or package builds
  • ❌ Author C++ classes (Blueprint-only — use Claude Code / Cursor for native code)
  • ❌ Make game design decisions (mechanics, story, art direction — that's still you)

Realistic expectation: WoalzCraft handles roughly 30–50% of the work in a typical Blueprint-heavy game project — the boilerplate-ish parts that are tedious to author by hand. The other 50–70% (assets, level design, polish, build pipeline, creative direction) still needs you and other tools.

Where it fits in your pipeline

| Layer | Who handles it | |---|---| | Game design / story / art direction | You | | 3D models, textures | Quixel, Mixamo, Sketchfab, Blender | | Audio | Audacity, FMOD, Wwise | | VFX (particles) | Niagara (manual, for now) | | Blueprints — gameplay logic | WoalzCraft (this plugin) | | Multi-BP refactors / orchestration | WoalzCraft + Claude Code / Gemini CLI via MCP | | Materials & shaders | Manual (planned for Phase 4) | | Animation Blueprints | Manual (planned for Phase 6) | | Level design | UE5 World Partition tools | | Build / packaging | UE5 Project Launcher |

Want to see where WoalzCraft is going? Read the public roadmap — it covers expansion into Materials, Niagara, Anim BPs, and Editor Utility Widgets toward becoming a Technical Artist-grade tool over the next 12–18 months.

Path A · Browse the knowledge base (2 minutes)

The Brain (our knowledge base) holds 500+ examples, node references, and best-practice patterns that the plugin uses to generate Blueprints. You can browse the same content directly.

Step 1. Open the search page

Go to /search. No login. No paywall.

Step 2. Try a query

Type something you'd build in Unreal:

  • spawn actor
  • health bar
  • line trace
  • event begin play
  • enhanced input
  • projectile movement

Hit Search. You'll see results ranked by relevance, marked as one of:

  • Example — full Blueprint graph (BP_HealthBar, BP_PatrolAI, etc.)
  • Node ref — single-node reference with pin signatures and gotchas
  • Pattern — a best-practice text guide (when to use what, common mistakes)

Step 3. Open a result

Click any result. The detail page shows:

  • The full prose explanation
  • Pin diagrams (for node refs)
  • Raw Blueprint JSON (for examples — the format the plugin generates)
  • Usage stats ("looked up 423 times, 12 found helpful")

You can deep-link any of these. Share the URL with a teammate stuck on the same problem.

That's it for Path A. If browsing convinced you the AI knows your domain, jump to Path B below. Otherwise keep exploring — every entry on /search/... is publicly indexable, no friction.

Path B · Sign up + install + generate

The plugin needs a Brain API key. The easiest way is to sign up for a website account first; the API key is issued automatically when you confirm your email.

Step 1. Create your account

  1. Open /signup.
  2. Fill in:
    • Email — use a real address you can check
    • Password — at least 10 characters (a passphrase like "correct battery staple" works)
    • Display name — optional; shows up on contributions / leaderboard
  3. Click Sign up.
  4. Check your inbox. The email is from noreply@woalz.com, subject "Confirm your WoalzCraft email". If you don't see it within 2 minutes, check spam.
  5. Click the confirm button in the email. You'll land on a page that shows your API key ONCE. Copy it now — it's stored in an encrypted cookie for your browser, but the plain key is shown only this one time.

The key looks like wbk-u_<long-random-string>.

Step 2. Install the plugin

Option A · Drop into an existing project

  1. Download the latest plugin zip from /download.
  2. Extract into YourProject/Plugins/WoalzCraft/.
  3. Right-click your .uproject → Generate Visual Studio project files.
  4. Open the project in Unreal and let it compile. You'll see a Woalz Craft item in the toolbar.

Option B · Marketplace (coming soon)

Fab + UE Marketplace listings land with v1.0.

Step 3. Connect your AI provider

Open Edit → Project Settings → Plugins → Woalz Craft and choose an AI Provider:

| Provider | Setup | Notes | | --------------------- | ----------------------- | ---------------------------------------------------------------------- | | Anthropic Claude | Paste sk-ant-... key | Best quality for Blueprint generation. Free tier available. | | OpenAI | Paste sk-... key | Widely supported. GPT-4o or GPT-5 recommended. | | Google Gemini | Paste AIza... key | Free tier generous. gemini-2.5-flash is fast. | | Ollama | Point to local endpoint | Fully free, offline. Try qwen2.5-coder:32b. | | OpenAI-Compatible | Custom URL + key | Works with LM Studio, vLLM, llama.cpp, Mistral, any compatible server. |

Brain key: Either paste the wbk-u_... from Step 1, OR let the plugin auto-provision a free community-tier key on first launch (60 req/hr). User-tier keys (signed up + verified) get 300 req/hr.

Step 4. Generate your first Blueprint

  1. Open the Woalz Craft panel: Window → Woalz Craft (or via the toolbar button).

  2. Type a prompt, for example:

    Create a blueprint that prints "Hello, Unreal" every 2 seconds.

  3. Click Generate. The plugin will:

    • Search the Brain for similar few-shot examples.
    • Inject a UE-version-aware system prompt (UE 5.3 → 5.7).
    • Send the request to your chosen AI provider.
    • Parse the response, validate every node against a local lookup table.
    • Create the .uasset inside a scoped transaction.

  4. The generated Blueprint opens automatically. Compile (F7) to confirm it's clean.

Step 5. Iterate

  • Follow-up prompts edit the current Blueprint in-place. Try make the interval 500ms or log the iteration count too.
  • Accept a result to contribute it back to Brain (anonymized, quality-scored).
  • Debug Agent (enable in settings) can auto-fix compile errors by re-prompting with the error context.

Manage your account

Once signed in, /account is your dashboard. Click Profile settings for:

  • Profile — change your display name
  • Security — rotate your password
  • API keys — see every device with a live key, revoke individual keys, "Sign out everywhere"
  • Recent activity — sign-ins, failed attempts, password changes, with location info ("Jakarta, Indonesia") so you can spot anything weird
  • Link a plugin key — if you installed the plugin BEFORE signing up, grab your anonymous key by typing WoalzCraft.ShowKey in the UE Output Log console (it'll auto-copy to clipboard), then paste it here to merge history into your account. Available in plugin v0.9.0-alpha4+

Quotas and tiers

| Tier | How to get it | Quota | | ------------- | ------------------------------------------ | ------------- | | community | Plugin auto-signup on first launch | 60 req/hr | | user | Sign up via website + verify email | 300 req/hr | | write | Contributors / agents (admin-issued) | Higher | | admin | Won only | No cap |

If you hit the quota, the plugin falls back to local-only behaviour (using cached examples + your AI provider directly) until the next hour rolls over.

What if something goes wrong?

Email never arrives

"Too many failed sign-in attempts"

The per-email circuit breaker tripped. Wait 15 minutes, or use the password reset flow (a successful reset clears the lockout).

Plugin says "key not recognised"

Your cached BrainReadKey was revoked server-side. Common causes:

  • You did a password reset (which revokes all active keys for safety)
  • Admin manually revoked it
  • The plugin auto-signup hit the lifetime cap (3 keys per fingerprint)

Quick check: type WoalzCraft.ShowKey in the UE Output Log console — if it prints a key, that's the one being used. If you see "no key cached", auto-signup hasn't run yet.

Fix:

  • Click Reset & Re-provision Community Key in Project Settings → Woalz Brain, OR
  • Type WoalzCraft.RetryAutoSignup in the console to force a fresh community-tier key, OR
  • Sign in at /account and use Link a plugin key to attach a new one to your user account.

Generated Blueprint won't compile

The plain-English diagnostic translator kicks in. Instead of:

Pin type mismatch: CompilerResultsLog: connection cannot be made

You'll see:

You connected a float output to a bool input. Insert a Compare node (e.g. > 0) or cast the float explicitly.

If the message still doesn't help, try a follow-up prompt like the compile fails because X — fix it and the AI usually patches itself.

"Email not verified" on login

You signed up but didn't click the confirm link. /forgot-password triggers a fresh verification email if the account is still pending.

Lost your API key

  • Sign in at /login (User tab) — issues a fresh session key
  • OR open the plugin and run the console command WoalzCraft.ShowKey to see the cached one in the .ini

Privacy + safety

  • Your email is stored to send transactional mail (verification, password reset). It's redacted in our logs (j***@gmail.com) so a log dump never spills the full address.
  • IP addresses are stored in login_events for security forensics and are visible to you on /account/profile. Coarse GeoIP (city + country) is fetched from ipapi.co; we don't store latitude / longitude.
  • Generated Blueprints you choose to contribute are anonymised (your name is hashed) before they enter the public knowledge base.
  • We never train models on your contributions without explicit opt-in. The Brain is a curated knowledge base, not a model fine-tuning corpus.
  • All session cookies are httpOnly + encrypted. The site uses iron-session; your bearer token never reaches the browser JavaScript.

Get help

Quick reference

| What I want to do | Where to go | | --------------------------------------- | -------------------------------------------- | | Browse the knowledge base | /search | | Create an account | /signup | | Sign in | /login | | Forgot password | /forgot-password | | Magic-link login (passwordless) | Use the Magic link tab on /login | | Manage profile / sessions / passwords | /account/profile | | Download the plugin | /download | | See what's new | /changelog | | Contribute / report a problem | support@woalz.com |

Have fun building.