# Extensiones — Godot · AI Game Developer Wiki Extensiones MCP opcionales de Godot: animación, CSG, GridMap, navegación, partículas, TileMapLayer, Beehave, Dialogic, Phantom Camera y Terrain3D. Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/wiki/godot/extensions). Las extensiones son paquetes NuGet opcionales que enseñan a Godot MCP más partes de Godot y de los addons populares de Godot. Instala solo las que tu proyecto necesite. Esta página las enumera, explica cómo funcionan y muestra las tres formas de instalar una. Las descripciones y los ejemplos de cada extensión están en la página [Godot extensions](https://ai-game.dev/docs/extensions/godot) del sitio. ## Cómo funcionan las extensiones Cada extensión es un módulo RQL. No añade herramientas MCP propias. En su lugar, amplía las herramientas principales `rql-query`, `rql-mutate` y `rql-schema` con nuevas fuentes, propiedades y llamadas validadas, y añade una guía a la skill `godot-rql` del agente. La lista de herramientas de tu agente sigue teniendo el mismo tamaño, y el agente aprende el área nueva a través de `rql-schema`: ```text rql-schema "Particles" ``` Los paquetes contienen código fuente en C# y ajustes de compilación, compilados contra el propio GodotSharp de tu proyecto. Cada extensión tiene su propia versión y su propio ciclo de publicación. ## Extensiones disponibles | Extensión | Id del paquete | Qué añade | Requiere | | --- | --- | --- | --- | | Animation Tools | `com.IvanMurzak.Godot.MCP.Animation` | Bibliotecas, animaciones, pistas y claves de AnimationPlayer | Godot 4.3+ | | Beehave Tools | `com.IvanMurzak.Godot.MCP.Beehave` | Lista árboles de comportamiento y sus nodos | Addon Beehave, Godot 4.3+ | | CSG Tools | `com.IvanMurzak.Godot.MCP.CSG` | Dimensiones validadas de las primitivas CSG y `rootShape` | Godot 4.3+ | | Dialogic Tools | `com.IvanMurzak.Godot.MCP.Dialogic` | Lista y crea timelines y personajes, y añade texto a las timelines | Addon Dialogic, Godot 4.4+ | | GridMap Tools | `com.IvanMurzak.Godot.MCP.GridMap` | Ajustes de GridMap, filas de celdas y edición de celdas | Godot 4.3+ | | Navigation Tools | `com.IvanMurzak.Godot.MCP.Navigation` | Agentes de navegación 2D y 3D, regiones, enlaces y horneado de regiones | Godot 4.3+ | | Particles Tools | `com.IvanMurzak.Godot.MCP.Particles` | Partículas GPU en 2D y 3D: ajustes del emisor validados y reinicio | Godot 4.3+ | | PhantomCamera Tools | `com.IvanMurzak.Godot.MCP.PhantomCamera` | Lista cámaras virtuales y hosts, y establece objetivos de seguimiento y de mirada | Addon Phantom Camera, Godot 4.4+ | | Terrain3D Tools | `com.IvanMurzak.Godot.MCP.Terrain3D` | Fuente de terreno, cambios de tamaño de región y creación de materiales | Addon Terrain3D, Godot 4.4+ | | Tilemap Tools | `com.IvanMurzak.Godot.MCP.Tilemap` | Filas de celdas usadas de TileMapLayer y edición de celdas | Godot 4.3+ | Todas las extensiones necesitan además un addon principal que tenga las herramientas RQL (cualquier versión posterior a la 0.28.0). **Nota** El instalador solo añade el paquete de la extensión. Para Beehave, Dialogic, Phantom Camera y Terrain3D, instala tú mismo primero ese addon de terceros en tu proyecto. ## Instalar con godot-cli ```bash godot-cli install-extension com.IvanMurzak.Godot.MCP.CSG ./MyGodotProject godot-cli build ./MyGodotProject ``` `install-extension` busca el id en el catálogo de extensiones, primero por id de paquete y luego por nombre, sin distinguir mayúsculas y minúsculas (así que `"CSG Tools"` también funciona). Después añade o actualiza un `` en el `.csproj` de tu proyecto: - si aún no está referenciado: se añade la referencia; - si hay referenciada una versión anterior: se actualiza; - si ya está actualizado: no cambia nada. Sin `--version`, la referencia apunta siempre a la última versión estable de NuGet (`Version="*"`). Usa `--version ` para solicitar una versión exacta. Después de instalar, compila el proyecto para que Godot restaure y compile el paquete; Godot no tiene un paso de restauración automática. ## Instalar desde el dock La sección **Extensions** del dock de AI Game Developer muestra el mismo catálogo con botones **Install** y **Update**. Edita el `.csproj` del mismo modo que la CLI. Vuelve a compilar después. Si el dock indica que no se encontró ningún `.csproj`, el addon no está dentro de un proyecto C# de Godot. ## Instalar desde la app AI Game Dev En el caso de los proyectos de Godot, la [app AI Game Dev](https://ai-game.dev/es/docs/wiki/app) muestra un botón **Extensions** en la barra lateral que abre el mismo catálogo e instala mediante el mismo código que `godot-cli`. Su comando de barra `/install-extension` hace lo mismo desde el chat de la app: sin argumentos enumera el catálogo y, con un id, instala en el proyecto actual. Las extensiones de motor no son lo mismo que los paquetes propios de la app. ## El catálogo de extensiones La lista de extensiones está en `addons/godot_mcp/extensions.catalog.json`, que se distribuye con el addon. El dock, `godot-cli` y la app leen este único archivo. El dock la lee desde tu proyecto compilado, por eso tu `.csproj` debe incrustarla: ```xml ``` `godot-cli install-plugin` y la app añaden esta línea por ti. Si instalaste a mano y la lista de Extensions aparece vacía, es que falta esta línea; añádela y vuelve a compilar. Consulta [Installation](https://ai-game.dev/es/docs/wiki/godot/installation#nuget-packages). ## Usar una extensión Después de compilar, simplemente pregunta. Por ejemplo, con CSG Tools instalado: - "Crea un combinador CSG con una caja de 3x3x3 y réstale una esfera de radio 1.8." - "Enumera cada forma CSG de la escena con su operación y su tamaño." El agente crea los nodos con `rql-mutate` (un paso deshacible por llamada) y comprueba el resultado con `rql-query`. Los valores no válidos, como un radio negativo, hacen fallar todo el cambio y dejan la escena intacta. ## Escribe tu propia extensión El repositorio de Godot-MCP contiene una plantilla de extensión (`templates/extension/`) y una guía de monorepo para compilar, probar y publicar módulos. Para herramientas puntuales de un proyecto, las [herramientas personalizadas](https://ai-game.dev/es/docs/wiki/godot/custom-tools) simples son más sencillas. --- Source (HTML): https://ai-game.dev/es/docs/wiki/godot/extensions Machine-translated (es) from the English page: https://ai-game.dev/docs/wiki/godot/extensions