Docs · Extensions · Unity

AI Particle System

Inspect and modify any of the 24 ParticleSystem modules — emission, shape, velocity, color-over-life, and more.

Last updated: 2026-10-17 View as Markdown

At a glance

Capabilities
2 capabilities
Version
2.0.0
Package id
com.ivanmurzak.unity.mcp.particlesystem
Engine
Unity · Unity 2022.3+
Wraps
com.unity.modules.particlesystem
Repository

What the agent can do with it

Adds no MCP tools: it contributes an RQL module and adapters for ParticleSystem, ParticleSystem modules, MinMaxCurve, MinMaxGradient. That powers 2 capabilities the agent reaches through rql-query / rql-mutate. How RQL works →

  • Particle system settings

    Read and change any of the 24 ParticleSystem modules — main, emission, shape, colour and size over lifetime, noise, collision, trails, renderer and more.

    objects | get components | where $ is ParticleSystem | set main.startLifetime = 3, emission.rateOverTime = [5, 25], main.startColor = "#ff8800"
  • Particle playback

    Play, pause, stop or clear a particle system, or simulate it for a number of seconds.

    objects | get components | where $ is ParticleSystem | call Simulate(2)

See it in the Unity catalog →

Install

Requires the base plugin com.ivanmurzak.unity.mcp. After installing, the RQL module loads with the package — the agent sees it in rql-schema.

OpenUPMopenupm add com.ivanmurzak.unity.mcp.particlesystem

When to ask the AI for it

Ask for VFX tuning — emission rate, particle lifetime, shape, size and color over lifetime — on an existing ParticleSystem.

Not sure if it's installed? Ask the agent to run rql-schema "ParticleSystem" — 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. On the `Fire` ParticleSystem, set the emission rate to 50 and the start color to a warm orange.
  2. Inspect every module on the selected ParticleSystem and tell me which ones are enabled.

Keep going