MCP // VFX

MCP for game VFX

Connect your agent to an MCP server that compiles effects, and you can ask for game VFX in plain words: a fire that loops, an explosion that plays once, smoke that leans with the wind. Spatial Compiler's hosted server returns sprite sheets your engine plays, and in Godot 4 your agent drops each one into a scene.

  • Godot 4 Available
  • Unity Manual setup
  • Unreal Engine Manual setup
  • Roblox Studio Manual setup
  • three.js Available

A draft compile is from $0.05, and new accounts start with $5 of usage.

WINDOW_FIREFINAL
First frame of the window_fire bake
Window fire, 3.9 x 4.7 m, compiled with Spatial Compiler. Spec →

01 // HOW TO

How your agent gets an effect right

MCP is the protocol your agent uses to call tools. With Spatial Compiler's tools, your agent repeats these steps until the effect passes its checks.

  1. Describe the effect and where it goes, for example a room fire venting from a window, as a loop.
  2. Your agent copies the nearest of the eight examples, here window_fire, and calls check, which names any bad key and its valid range.
  3. It compiles a draft (from $0.05) and opens preview_strip.png to judge the look.
  4. If you want options, it calls sweep to compile up to 16 draft variants side by side.
  5. It compiles at final quality (from $0.10) until the report says "ok": true with an empty warnings list, then calls wire if your project is in Godot 4.
MCP calls
bake {"spec": "<name>.pyro.toml", "out": "<dir>", "quality": "final"}
wire {"bake_dir": "<dir>", "scene": "<path>.tscn"}

02 // EXAMPLES

Which example to start from

  • fire: a steady 2 s loop about 1.5 m across, for a wreck or a big campfire.
  • fire_whirl: flames spun into a tall column, a 2 s loop.
  • window_fire: a burning room venting through a window, a 2 s loop.
  • fireball: a fuel explosion that rolls upward, one-shot, 3.7 s.
  • impact: a shell hitting dry ground, one-shot, 2.0 s.
  • smoke_plume: wreck or chimney smoke leaning with the wind, a 4 s loop.
  • smoke_column: smoke that climbs and thins after a burst, one-shot, 5.0 s.
  • dust_ring: a ring of dust thrown out by a blast or a landing, one-shot, 2.1 s.

03 // REAL OUTPUT

Three of the eight examples

Each is a final compile of 64 frames on an 8 x 8 grid.

IMPACTFINAL
First frame of the impact bake
Impact, 3.5 x 2.8 m, compiled with Spatial Compiler. Spec →
SMOKE_PLUMEFINAL
First frame of the smoke_plume bake
Smoke plume, 7.0 x 10.8 m, compiled with Spatial Compiler. Spec →

04 // ENGINES

Where the effects play

In Godot 4, wire writes a scene with a shader that relights the smoke from your sun, adds the flame as HDR light and fades the effect where it meets floors and walls. See Godot MCP.

06 // FAQ

Game VFX over MCP questions

All questions →

README.VFX
What is VFX in games?

Game VFX are visual effects layered onto a scene, such as fire, smoke, explosions and dust, usually drawn as flipbooks or particles.

How do I make VFX for games with an AI agent?

Describe the effect so your agent starts from the nearest example spec, iterates on draft compile and runs a final compile from $0.10.

How many frames should an explosion VFX flipbook use?

A default compile uses 64 frames on an 8 by 8 grid, spanning 4 seconds for fireball and 3.2 seconds for impact.

How do I make multiple explosions look varied instead of identical?

Compile the same effect with different seeds for unique instances or run a sweep of up to 16 draft variants to compare settings.

Should I use PNG or EXR for a game VFX sprite sheet?

Use PNG for game engines, with png8 as the default or png16 for finer gradients and choose EXR when you need full HDR range.

Compile your first effect

You pay per compile and see the price before it runs. New accounts start with $5 of usage.

All effects, guides and explainers →