Docs · Extensions · Godot

AI Particles

Teaches RQL Godot GPU particles (2D and 3D) — validated Amount, Lifetime, Explosiveness and Randomness, plus a Restart() call; set the process material and emitting state as properties.

Last updated: 2026-11-15 View as Markdown

At a glance

Capabilities
2 capabilities
Version
1.1.2
Package id
com.IvanMurzak.Godot.MCP.Particles
Engine
Godot · Godot 4.3+
Wraps
GPUParticles
Repository

What the agent can do with it

Adds no MCP tools: it contributes an RQL module with adapters for GPUParticles3D, GPUParticles2D. That powers 2 capabilities the agent reaches through rql-query / rql-mutate. How RQL works →

  • Emitter settings

    Set validated Amount, Lifetime, Explosiveness and Randomness on GPUParticles2D / 3D (an out-of-range value fails), plus the process material and emitting state.

    nodes | where name == "FX" | set Amount = 32, Lifetime = 2, Explosiveness = 0.5
  • Restart emitters

    Restart a GPU particle emitter from the beginning.

    nodes | where name == "FX" | call Restart()

See it in the Godot catalog →

Install

Requires the base plugin godot_mcp. Then build the project (godot-cli build <GodotProject>); the RQL module loads with the package — the agent sees it in rql-schema.

godot-cligodot-cli install-extension com.IvanMurzak.Godot.MCP.Particles <GodotProject>

When to ask the AI for it

Ask for VFX in Godot — a spark or smoke emitter and tuning its emission properties.

Not sure if it's installed? Ask the agent to run rql-schema "GPUParticles3D" — the extension's members and methods only appear when the package is present.

Example prompts

Copy-pasteable first requests. Start with one, verify it in the editor, then build up.

  1. Create a GPUParticles3D named FX with 32 particles, a 2-second lifetime and 0.5 explosiveness, using a new ParticleProcessMaterial.
  2. Restart the FX emitter.

Keep going