KI-gestützte Partikelsysteme in Unity: Die ParticleSystem-Erweiterung

Unitys ParticleSystem ist eine der mächtigsten – und komplexesten – Komponenten der Engine. Mit 24 separaten Modulen, Hunderten von Parametern und tief verschachtelten Einstellungen bedeutet das manuelle Konfigurieren eines Partikeleffekts, sich durch endlose Inspector-Panels zu klicken. Was wäre, wenn du einer KI einfach sagen könntest „erzeuge Feuerpartikel, die von Orange nach Transparent ausblenden" und es wäre in Sekunden erledigt? Genau das ermöglicht die Unity-AI-ParticleSystem-Erweiterung.

Was ist Unity-AI-ParticleSystem?

Unity-AI-ParticleSystem ist eine Erweiterung für AI Game Developer, die zwei MCP-Tools hinzufügt – particle-system-get und particle-system-modify – und damit KI-Agenten vollen Lese- und Schreibzugriff auf jedes ParticleSystem-Modul in deinem Unity-Projekt gibt. Sie funktioniert mit jedem MCP-kompatiblen KI-Client: Claude Code, VS Code Copilot, Cursor, Windsurf und mehr.

Zwei Tools, volle Abdeckung

Die Erweiterung stellt nur zwei MCP-Tools bereit, die aber alles abdecken. Das get-Tool liest den aktuellen Zustand eines beliebigen ParticleSystem, und das modify-Tool wendet Teil-Updates an – es ändert nur die Eigenschaften, die du angibst, und lässt alles andere unangetastet.

particle-system-get

Ruft den vollständigen Zustand eines ParticleSystem ab, inklusive Wiedergabestatus (isPlaying, isPaused, particleCount) und jeder beliebigen Kombination seiner 24 Module. Du kannst einzelne Module anfordern oder mit dem includeAll-Flag alles auf einmal abrufen. Der Deep-Serialization-Modus erweitert verschachtelte Objekte rekursiv für eine vollständige Inspektion.

{
  "tool": "particle-system-get",
  "input": {
    "gameObjectRef": { "path": "/Effects/Fire" },
    "includeMain": true,
    "includeEmission": true,
    "includeColorOverLifetime": true
  }
}

particle-system-modify

Wendet Teil-Updates auf jedes Modul an. Nur die Eigenschaften, die du in der Anfrage angibst, werden geändert – alles andere bleibt, wie es ist. Das Tool gibt detaillierte Änderungsprotokolle zurück, damit die KI genau weiß, was aktualisiert wurde.

{
  "tool": "particle-system-modify",
  "input": {
    "gameObjectRef": { "path": "/Effects/Fire" },
    "main": [
      { "memberPath": "duration", "value": 5.0 },
      { "memberPath": "startLifetime.constant", "value": 2.0 },
      { "memberPath": "loop", "value": true }
    ],
    "emission": [
      { "memberPath": "rateOverTime.constant", "value": 50 }
    ]
  }
}

Alle 24 Module werden unterstützt

Die Erweiterung deckt jedes einzelne in Unity verfügbare ParticleSystem-Modul ab. Die KI kann alle lesen und ändern:

• Main – Dauer, Start-Lebensdauer, Start-Geschwindigkeit, Start-Größe, Start-Farbe, Gravitation, Simulationsraum, Loop
• Emission – Rate über Zeit, Rate über Distanz, Bursts
• Shape – Formtyp, Radius, Winkel, Arc, Position, Rotation, Skalierung
• Velocity Over Lifetime – lineare und orbitale Geschwindigkeitskurven
• Limit Velocity Over Lifetime – Geschwindigkeitsgrenzen und Dämpfung
• Color Over Lifetime – gradientbasierte Farbanimation
• Color By Speed – Farbe an die Partikelgeschwindigkeit gekoppelt
• Size Over Lifetime – Größenkurven über die Lebensdauer der Partikel
• Size By Speed – Größe an die Partikelgeschwindigkeit gekoppelt
• Rotation Over Lifetime – Winkelgeschwindigkeitskurven
• Noise – Turbulenz- und Perlin-Noise-Felder
• Collision – Kollisionseinstellungen für Welt und Ebenen
• Trails – Rendering von Partikel-Trails
• Renderer – Material, Mesh, Render-Modus, Sortierung
• Plus: Force Over Lifetime, External Forces, Inherit Velocity, Lifetime By Emitter Speed, Rotation By Speed, Trigger, Sub Emitters, Texture Sheet Animation, Lights, Custom Data

Praxisbeispiel: Was du die KI fragen kannst

Weil die KI vollen Zugriff auf jeden ParticleSystem-Parameter hat, kannst du Anfragen in normaler Sprache stellen, und die KI findet selbst heraus, welche Module und Eigenschaften geändert werden müssen:

• „Erstelle einen Lagerfeuer-Effekt mit orange bis rot leuchtenden Partikeln, die aufsteigen und verblassen"
• „Mach die Rauchpartikel größer und langsamer, mit mehr Turbulenz"
• „Füge Kollision hinzu, damit die Funken vom Boden abprallen"
• „Aktiviere Trails für die Partikel des magischen Projektils"
• „Verdopple die Emissionsrate und lass die Partikel dauerhaft loopen"
• „Ändere die Form von Kegel zu Kugel und erhöhe den Radius"

Installation

Die Erweiterung setzt voraus, dass AI Game Developer (Unity-MCP) zuerst installiert ist. Danach fügst du die ParticleSystem-Erweiterung über OpenUPM oder den .unitypackage-Installer hinzu.

Option A: OpenUPM (empfohlen)

openupm add com.ivanmurzak.unity.mcp.particlesystem

Option B: Unity Package Installer

Folge dem Installer-Download in der README der Erweiterung unter github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ParticleSystem/README.md und importiere das .unitypackage über Assets > Import Package > Custom Package in dein Unity-Projekt.

So funktioniert es unter der Haube

Die Module des Unity ParticleSystem sind C#-Structs, keine Klassen – sie lassen sich also nicht über einfache Reflection ändern. Die Erweiterung nutzt ReflectorNet, um jedes Modul zu boxen, Änderungen über serialisierte Member-Diffs anzuwenden und den geänderten Wert anschließend zurückzuschreiben. Alle Unity-API-Aufrufe werden an den Main Thread weitergeleitet, und die Editor-Fenster werden nach jeder Änderung neu gezeichnet, sodass du die Änderungen sofort siehst.

// The extension registers tools via attributes — Unity-MCP discovers them automatically
[AiToolType]
public partial class Tool_ParticleSystem
{
    [AiTool("particle-system-get", Description = "Get ParticleSystem data")]
    public async Task<string> GetParticleSystem(
        GameObjectRef gameObjectRef,
        bool includeMain = false,
        bool includeEmission = false,
        bool includeShape = false,
        // ... flags for all 24 modules
        bool includeAll = false,
        bool deepSerialization = true)
    {
        // Serializes requested modules and returns structured JSON
    }
}

Kompatibilität

• Unity 2022.3 oder neuer
• Setzt AI Game Developer (Unity-MCP) v0.60.0+ voraus
• Funktioniert mit jedem MCP-Client: Claude Code, VS Code Copilot, Cursor, Windsurf, Continue
• Getestet mit Unity 2022.3, 2023.2 und Unity 6 (6000.3)

Loslegen

Installiere AI Game Developer, füge die ParticleSystem-Erweiterung hinzu und beschreibe einfach die Effekte, die du haben willst. Den Rest übernimmt die KI. Die vollständige Einrichtung findest du im Quickstart-Guide unter ai-game.dev/docs/quickstart, oder hole dir das Plugin über die Download-Seite unter ai-game.dev/download.

• Unity-AI-ParticleSystem: github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ParticleSystem/README.md
• AI Game Developer (Unity-MCP): github.com/IvanMurzak/Unity-MCP
• AI Animation Extension: github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md
• AI ProBuilder Extension: github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ProBuilder/README.md
• Download: ai-game.dev/download
• Quickstart-Guide: ai-game.dev/docs/quickstart
• Setup-Tutorial: ai-game.dev/blog/claude-code-unity-tutorial