Erweiterungen
Unity-MCP-Erweiterungen für Animation, Cinemachine, Input System, Navigation, ProBuilder, Splines, Terrain, Tilemap, Timeline und Partikel.
Erweiterungen sind optionale Unity-Pakete, die dem KI-Agenten bestimmte Unity-Funktionen näherbringen, etwa Cinemachine-Kameras, ProBuilder-Meshes oder 2D-Tilemaps. Installiere nur die, die dein Projekt verwendet. Diese Seite listet die zehn offiziellen Erweiterungen auf, was jede davon hinzufügt und wie man sie installiert. Jede Erweiterung hat außerdem eine Detailseite im Unity-Erweiterungskatalog.
So funktionieren Erweiterungen
Seit Unity MCP 1.0.0 (und Erweiterungsversion 2.0.0) fügt eine Erweiterung keine neuen MCP-Tools hinzu. Stattdessen liefert sie ein RQL-Modul: neue Sources, Funktionen und Typadapter, die die bestehenden Tools rql-query und rql-mutate verstehen. Die Tool-Liste des Agenten bleibt gleich groß, und die Anleitung der Erweiterung wird dem generierten Skill unity-rql hinzugefügt, sodass der Agent die neue Syntax lernt, sobald das Paket installiert und die Skills neu generiert sind.
Zum Beispiel kann der Agent mit installiertem AI Tilemap Tiles über RQL malen:
objects | get components | where $ is Tilemap | call BoxFill("Assets/Tiles/Grass.asset", -5, -3, 5, 3)Jede Erweiterung hängt vom Kern-Plugin com.ivanmurzak.unity.mcp und von dem Unity-Paket ab, auf dem sie aufbaut. Bei der Installation werden beide mitgezogen. Alle unterstützen Unity 2022.3 und neuer.
Die offiziellen Erweiterungen
| Erweiterung | Paket-ID | Baut auf | RQL-Ergänzungen |
|---|---|---|---|
| AI Animation | com.ivanmurzak.unity.mcp.animation | Animationsmodul | animation-Source; Typen AnimationClip, AnimatorController und Animator |
| AI Cinemachine | com.ivanmurzak.unity.mcp.cinemachine | com.unity.cinemachine | cinemachine-Source; CinemachineCamera, CinemachineBrain |
| AI InputSystem | com.ivanmurzak.unity.mcp.inputsystem | com.unity.inputsystem | input-Source; InputActionAsset |
| AI Navigation | com.ivanmurzak.unity.mcp.navigation | com.unity.ai.navigation | navigation-Source; NavMeshSurface, NavMeshLink, NavMeshAgent |
| AI Particle System | com.ivanmurzak.unity.mcp.particlesystem | Partikelsystem-Modul | ParticleSystem und seine Module, Kurven und Gradienten |
| AI ProBuilder | com.ivanmurzak.unity.mcp.probuilder | com.unity.probuilder | probuilder-Source und Funktionen; ProBuilderMesh |
| AI Splines | com.ivanmurzak.unity.mcp.splines | com.unity.splines | splines-Source; SplineContainer |
| AI Terrain | com.ivanmurzak.unity.mcp.terrain | Terrain-Module | terrain-Source; Höhenfunktionen; Terrain, TerrainData |
| AI Tilemap | com.ivanmurzak.unity.mcp.tilemap | Tilemap-Modul und 2D Tilemap Extras | tilemap-Source und Funktionen; Tilemap, RuleTile |
| AI Timeline | com.ivanmurzak.unity.mcp.timeline | com.unity.timeline | timeline-Source; TimelineAsset, Tracks, Clips, PlayableDirector |
Die genauen Sources, Funktionen und Aufrufe jedes Moduls stehen auf seiner Katalogseite und im Editor in rql-schema.
Installation im AI Game Developer-Fenster
- Öffne Window > AI Game Developer — MCP.
- Scrolle zu Extensions.
- Klicke bei der gewünschten Erweiterung auf Install.
Das Fenster fügt die gescopte OpenUPM-Registry und das Paket in der neuesten OpenUPM-Version zu Packages/manifest.json hinzu. Unity löst es dann auf und importiert es.
Installation mit unity-mcp-cli
unity-mcp-cli install-extension --list
unity-mcp-cli install-extension Tilemap ./MyUnityProjectDie ID kann der Katalogname (Tilemap, Cinemachine, ProBuilder, …) oder die Paket-ID (com.ivanmurzak.unity.mcp.tilemap) sein, wobei die Groß-/Kleinschreibung keine Rolle spielt. Der Pfad ist standardmäßig der aktuelle Ordner. Der Befehl ermittelt die neueste OpenUPM-Version, stuft eine höhere installierte Version nie herab und tut nichts, wenn die Erweiterung bereits aktuell ist. Eine Version lässt sich mit --extension-version <version> festnageln (nicht mit --version, das die CLI-Version ausgibt). Öffne oder fokussiere Unity danach, damit der Package Manager es auflöst.
Installation mit OpenUPM
openupm add com.ivanmurzak.unity.mcp.cinemachineDie README jeder Erweiterung im Unity-MCP-Repository verlinkt außerdem einen .unitypackage-Installer für diese Erweiterung, der wie der Core-Installer funktioniert.
Installation mit der Desktop-App
Die AI Game Dev App kann Unity-Erweiterungen ebenfalls in das geöffnete Projekt installieren. Sie verwendet die eigene OpenUPM-Version jeder Erweiterung, die unabhängig von der Version des Kern-Plugins ist. Siehe die App-Dokumentation.
Nach der Installation
- Generiere die Skills neu (Skills > Generate im Fenster oder
unity-mcp-cli setup-skills <agent>), damit der Skillunity-rqldes Agenten das neue Modul enthält. - Bitte den Agenten, von
rql-schemaauszugehen, wenn er die neuen Typen nicht zu kennen scheint, zum Beispiel: „Nutze rql-schema, um zu sehen, was die cinemachine-Source bietet, und füge dann eine Follow-Kamera für den Player hinzu.“ - Tool-Namen aus älteren Tutorials wie
tilemap-set-tileodercinemachine-camera-creategibt es nicht mehr. Die README jeder Erweiterung ordnet sie dem entsprechenden RQL-Äquivalent zu.
Aktualisieren und Entfernen
Erweiterungen werden getrennt vom Kern-Plugin versioniert. Aktualisiere sie im Package Manager oder indem du install-extension erneut ausführst. Entferne eine im Package Manager wie jedes andere Paket. Halte Kern-Plugin und Erweiterungen gemeinsam auf aktuellen Versionen: Erweiterungen geben die minimale Kern-Version an, die sie benötigen.
Eigene Erweiterungen schreiben
Dein Projektcode kann Tools direkt hinzufügen (siehe Eigene Tools) oder RQL mit eigenen RQL-Adaptern deine eigenen Typen beibringen. Der Erweiterungsleitfaden im Repository beschreibt, wie die offiziellen Erweiterungen gebaut und getestet werden.