Esta página se tradujo automáticamente del inglés. Lee el original en inglés.

Extensiones

Extensiones MCP opcionales de Godot: animación, CSG, GridMap, navegación, partículas, TileMapLayer, Beehave, Dialogic, Phantom Camera y Terrain3D.

Actualizado el 4 de noviembre de 2026 Ver como Markdown

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

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ónId del paqueteQué añadeRequiere
Animation Toolscom.IvanMurzak.Godot.MCP.AnimationBibliotecas, animaciones, pistas y claves de AnimationPlayerGodot 4.3+
Beehave Toolscom.IvanMurzak.Godot.MCP.BeehaveLista árboles de comportamiento y sus nodosAddon Beehave, Godot 4.3+
CSG Toolscom.IvanMurzak.Godot.MCP.CSGDimensiones validadas de las primitivas CSG y rootShapeGodot 4.3+
Dialogic Toolscom.IvanMurzak.Godot.MCP.DialogicLista y crea timelines y personajes, y añade texto a las timelinesAddon Dialogic, Godot 4.4+
GridMap Toolscom.IvanMurzak.Godot.MCP.GridMapAjustes de GridMap, filas de celdas y edición de celdasGodot 4.3+
Navigation Toolscom.IvanMurzak.Godot.MCP.NavigationAgentes de navegación 2D y 3D, regiones, enlaces y horneado de regionesGodot 4.3+
Particles Toolscom.IvanMurzak.Godot.MCP.ParticlesPartículas GPU en 2D y 3D: ajustes del emisor validados y reinicioGodot 4.3+
PhantomCamera Toolscom.IvanMurzak.Godot.MCP.PhantomCameraLista cámaras virtuales y hosts, y establece objetivos de seguimiento y de miradaAddon Phantom Camera, Godot 4.4+
Terrain3D Toolscom.IvanMurzak.Godot.MCP.Terrain3DFuente de terreno, cambios de tamaño de región y creación de materialesAddon Terrain3D, Godot 4.4+
Tilemap Toolscom.IvanMurzak.Godot.MCP.TilemapFilas de celdas usadas de TileMapLayer y edición de celdasGodot 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).

Instalar con godot-cli

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 <PackageReference> 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 <x.y.z> 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 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:

<ItemGroup>
  <EmbeddedResource Include="addons/godot_mcp/extensions.catalog.json" LogicalName="Godot-MCP.extensions.catalog.json" />
</ItemGroup>

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.

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 simples son más sencillas.