Erweiterungen
Optionale MCP-Erweiterungen für Godot: AnimationPlayer, CSG, GridMap, Navigation, Partikel, TileMapLayer, Beehave, Dialogic, Phantom Camera, Terrain3D.
Erweiterungen sind optionale NuGet-Pakete, die Godot MCP mehr Teile von Godot und beliebte Godot-Addons beibringen. Installiere nur die, die dein Projekt braucht. Diese Seite listet sie auf, erklärt, wie sie funktionieren, und zeigt die drei Wege, eine zu installieren. Beschreibungen und Beispiele für jede Erweiterung findest du auf der Seite Godot-Erweiterungen.
So funktionieren Erweiterungen
Jede Erweiterung ist ein RQL-Modul. Sie fügt keine eigenen MCP-Tools hinzu. Stattdessen erweitert sie die Kern-Tools rql-query, rql-mutate und rql-schema um neue Quellen, validierte Eigenschaften und Aufrufe und ergänzt einen Leitfaden in der godot-rql-Skill des Agenten. Die Tool-Liste deines Agenten bleibt gleich groß, und der Agent lernt den neuen Bereich über rql-schema kennen:
rql-schema "Particles"Die Pakete enthalten C#-Quellcode und Build-Einstellungen, kompiliert gegen das GodotSharp deines Projekts. Jede Erweiterung hat ihre eigene Version und ihr eigenes Release.
Verfügbare Erweiterungen
| Erweiterung | Paket-ID | Was sie hinzufügt | Voraussetzung |
|---|---|---|---|
| Animation Tools | com.IvanMurzak.Godot.MCP.Animation | AnimationPlayer-Bibliotheken, Animationen, Tracks und Keys | Godot 4.3+ |
| Beehave Tools | com.IvanMurzak.Godot.MCP.Beehave | Verhaltensbäume und ihre Nodes auflisten | Beehave-Addon, Godot 4.3+ |
| CSG Tools | com.IvanMurzak.Godot.MCP.CSG | Validierte Abmessungen von CSG-Primitiven und rootShape | Godot 4.3+ |
| Dialogic Tools | com.IvanMurzak.Godot.MCP.Dialogic | Timelines und Charaktere auflisten und erstellen, Timeline-Text anhängen | Dialogic-Addon, Godot 4.4+ |
| GridMap Tools | com.IvanMurzak.Godot.MCP.GridMap | GridMap-Einstellungen, Zellzeilen und Zellbearbeitung | Godot 4.3+ |
| Navigation Tools | com.IvanMurzak.Godot.MCP.Navigation | 2D- und 3D-Navigationsagenten, Regionen, Links und Region-Baking | Godot 4.3+ |
| Particles Tools | com.IvanMurzak.Godot.MCP.Particles | GPU-Partikel in 2D und 3D: validierte Emitter-Einstellungen und Neustart | Godot 4.3+ |
| PhantomCamera Tools | com.IvanMurzak.Godot.MCP.PhantomCamera | Virtuelle Kameras und Hosts auflisten, Follow- und Look-at-Ziele setzen | Phantom Camera-Addon, Godot 4.4+ |
| Terrain3D Tools | com.IvanMurzak.Godot.MCP.Terrain3D | Terrain-Quelle, Änderungen der Regionsgröße und Materialerstellung | Terrain3D-Addon, Godot 4.4+ |
| Tilemap Tools | com.IvanMurzak.Godot.MCP.Tilemap | Verwendete Zellzeilen von TileMapLayer und Zellbearbeitung | Godot 4.3+ |
Jede Erweiterung benötigt außerdem ein Kern-Addon mit den RQL-Tools (jede Version nach 0.28.0).
Installation mit godot-cli
godot-cli install-extension com.IvanMurzak.Godot.MCP.CSG ./MyGodotProject
godot-cli build ./MyGodotProjectinstall-extension sucht die ID im Erweiterungskatalog nach, zuerst anhand der Paket-ID und dann anhand des Namens, ohne Beachtung der Groß-/Kleinschreibung (also funktioniert auch "CSG Tools"). Danach fügt es eine <PackageReference> in der .csproj deines Projekts hinzu oder aktualisiert sie:
- noch nicht referenziert: die Referenz wird hinzugefügt;
- eine ältere Version ist referenziert: sie wird aktualisiert;
- bereits aktuell: es ändert sich nichts.
Ohne --version verweist die Referenz auf die neueste stabile Version auf NuGet (Version="*"). Mit --version <x.y.z> forderst du eine exakte Version an. Baue das Projekt nach der Installation, damit Godot das Paket wiederherstellt und kompiliert; Godot hat keinen automatischen Restore-Schritt.
Installation über das Dock
Der Bereich Extensions im AI Game Developer Dock listet denselben Katalog mit den Schaltflächen Install und Update. Er bearbeitet die .csproj genauso wie die CLI. Baue danach neu. Wenn das Dock meldet, dass keine .csproj gefunden wurde, liegt das Addon nicht in einem Godot-C#-Projekt.
Installation über die AI Game Dev App
Für Godot-Projekte zeigt die AI Game Dev App eine Schaltfläche Extensions in der Seitenleiste, die denselben Katalog öffnet und über denselben Code wie godot-cli installiert. Ihr Slash-Befehl /install-extension erledigt dasselbe im Chat der App: ohne Argumente listet er den Katalog auf, mit einer ID installiert er in das aktuelle Projekt. Engine-Erweiterungen sind nicht dasselbe wie die eigenen Pakete der App.
Der Erweiterungskatalog
Die Liste der Erweiterungen liegt in addons/godot_mcp/extensions.catalog.json, die mit dem Addon ausgeliefert wird. Dock, godot-cli und die App lesen alle diese eine Datei. Das Dock liest sie aus deinem kompilierten Projekt, deshalb muss deine .csproj sie einbetten:
<ItemGroup>
<EmbeddedResource Include="addons/godot_mcp/extensions.catalog.json" LogicalName="Godot-MCP.extensions.catalog.json" />
</ItemGroup>godot-cli install-plugin und die App fügen diese Zeile für dich hinzu. Wenn du manuell installiert hast und die Extensions-Liste leer ist, fehlt diese Zeile; füge sie hinzu und baue neu. Siehe Installation.
Eine Erweiterung verwenden
Frag nach dem Build einfach. Zum Beispiel mit installierten CSG Tools:
- "Erstelle einen CSG-Combiner mit einer 3x3x3-Box und subtrahiere eine Kugel mit Radius 1.8 davon."
- "Liste jede CSG-Form in der Szene mit ihrer Operation und Größe auf."
Der Agent erstellt die Nodes mit rql-mutate (ein rückgängig machbarer Schritt pro Aufruf) und prüft das Ergebnis mit rql-query. Ungültige Werte, etwa ein negativer Radius, lassen die gesamte Änderung fehlschlagen und die Szene unverändert.
Schreibe deine eigene Erweiterung
Das Godot-MCP-Repository enthält eine Erweiterungsvorlage (templates/extension/) und eine Monorepo-Anleitung zum Bauen, Testen und Veröffentlichen von Modulen. Für einmalige Projektwerkzeuge sind einfache benutzerdefinierte Tools unkomplizierter.