# Erweiterungen — Unity · AI Game Developer Wiki

Unity-MCP-Erweiterungen für Animation, Cinemachine, Input System, Navigation, ProBuilder, Splines, Terrain, Tilemap, Timeline und Partikel.

Diese Seite wurde maschinell aus dem Englischen übersetzt. [Englisches Original lesen](https://ai-game.dev/docs/wiki/unity/extensions).

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](https://ai-game.dev/docs/extensions/unity).

## 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:

```text
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](https://ai-game.dev/docs/extensions/unity) und im Editor in `rql-schema`.

## Installation im AI Game Developer-Fenster

1. Öffne **Window > AI Game Developer — MCP**.
2. Scrolle zu **Extensions**.
3. 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

```bash
unity-mcp-cli install-extension --list
unity-mcp-cli install-extension Tilemap ./MyUnityProject
```

Die 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

```bash
openupm add com.ivanmurzak.unity.mcp.cinemachine
```

Die README jeder Erweiterung im [Unity-MCP-Repository](https://github.com/IvanMurzak/Unity-MCP/tree/main/extensions) verlinkt außerdem einen `.unitypackage`-Installer für diese Erweiterung, der wie der [Core-Installer](https://ai-game.dev/de/docs/wiki/unity/installation#installer) funktioniert.

## Installation mit der Desktop-App

Die [AI Game Dev App](https://ai-game.dev/docs/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](https://ai-game.dev/de/docs/wiki/app).

## Nach der Installation

- Generiere die Skills neu (**Skills > Generate** im Fenster oder `unity-mcp-cli setup-skills <agent>`), damit der Skill `unity-rql` des Agenten das neue Modul enthält.
- Bitte den Agenten, von `rql-schema` auszugehen, 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-tile` oder `cinemachine-camera-create` gibt 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](https://ai-game.dev/de/docs/wiki/unity/custom-tools)) oder RQL mit [eigenen RQL-Adaptern](https://ai-game.dev/docs/rql/custom-adapters) deine eigenen Typen beibringen. Der [Erweiterungsleitfaden](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/dev/extensions.md) im Repository beschreibt, wie die offiziellen Erweiterungen gebaut und getestet werden.

## Verwandte Seiten

- [Unity-Erweiterungskatalog](https://ai-game.dev/docs/extensions/unity) und [alle Erweiterungen](https://ai-game.dev/docs/extensions).
- [Tools und RQL](https://ai-game.dev/de/docs/wiki/unity/tools-and-rql).

---

Source (HTML): https://ai-game.dev/de/docs/wiki/unity/extensions

Machine-translated (de) from the English page: https://ai-game.dev/docs/wiki/unity/extensions