Extensiones
Las extensiones de Unity MCP añaden soporte para Animation, Cinemachine, Input System, Navigation, ProBuilder, Splines, Terrain, Tilemap, Timeline y partículas.
Las extensiones son paquetes opcionales de Unity que enseñan al agente de IA funciones concretas de Unity, como las cámaras de Cinemachine, las mallas de ProBuilder o los tilemaps 2D. Instala solo las que use tu proyecto. Esta página enumera las diez extensiones oficiales, qué añade cada una y cómo instalarla. Cada extensión también tiene una página de detalle en el catálogo de extensiones de Unity.
Cómo funcionan las extensiones
Desde Unity MCP 1.0.0 (y la versión 2.0.0 de las extensiones), una extensión no añade nuevas herramientas MCP. En su lugar, aporta un módulo RQL: nuevas fuentes, funciones y adaptadores de tipos que las herramientas existentes rql-query y rql-mutate entienden. La lista de herramientas del agente mantiene el mismo tamaño, y la guía de la extensión se añade a la skill unity-rql generada, de modo que el agente aprende la nueva sintaxis en cuanto se instala el paquete y se regeneran las skills.
Por ejemplo, con AI Tilemap instalada el agente puede pintar tiles mediante RQL:
objects | get components | where $ is Tilemap | call BoxFill("Assets/Tiles/Grass.asset", -5, -3, 5, 3)Cada extensión depende del plugin principal, com.ivanmurzak.unity.mcp, y del paquete de Unity sobre el que se construye. Instalarla arrastra ambos. Todas son compatibles con Unity 2022.3 y versiones posteriores.
Las extensiones oficiales
| Extensión | Id del paquete | Se basa en | Añadidos a RQL |
|---|---|---|---|
| AI Animation | com.ivanmurzak.unity.mcp.animation | Módulo Animation | fuente animation; tipos AnimationClip, AnimatorController y Animator |
| AI Cinemachine | com.ivanmurzak.unity.mcp.cinemachine | com.unity.cinemachine | fuente cinemachine; CinemachineCamera, CinemachineBrain |
| AI InputSystem | com.ivanmurzak.unity.mcp.inputsystem | com.unity.inputsystem | fuente input; InputActionAsset |
| AI Navigation | com.ivanmurzak.unity.mcp.navigation | com.unity.ai.navigation | fuente navigation; NavMeshSurface, NavMeshLink, NavMeshAgent |
| AI Particle System | com.ivanmurzak.unity.mcp.particlesystem | Módulo Particle System | ParticleSystem y sus módulos, curvas y degradados |
| AI ProBuilder | com.ivanmurzak.unity.mcp.probuilder | com.unity.probuilder | fuente y funciones probuilder; ProBuilderMesh |
| AI Splines | com.ivanmurzak.unity.mcp.splines | com.unity.splines | fuente splines; SplineContainer |
| AI Terrain | com.ivanmurzak.unity.mcp.terrain | Módulos Terrain | fuente terrain; funciones de altura; Terrain, TerrainData |
| AI Tilemap | com.ivanmurzak.unity.mcp.tilemap | Módulo Tilemap y 2D Tilemap Extras | fuente y funciones tilemap; Tilemap, RuleTile |
| AI Timeline | com.ivanmurzak.unity.mcp.timeline | com.unity.timeline | fuente timeline; TimelineAsset, pistas, clips, PlayableDirector |
Las fuentes, funciones y llamadas exactas de cada módulo están en su página del catálogo y, dentro del Editor, en rql-schema.
Instalar desde la ventana de AI Game Developer
- Abre Window > AI Game Developer — MCP.
- Desplázate hasta Extensions.
- Haz clic en Install junto a la extensión que quieras.
La ventana añade el registro con ámbito de OpenUPM y el paquete a Packages/manifest.json, en la última versión disponible en OpenUPM. Después, Unity lo resuelve y lo importa.
Instalar con unity-mcp-cli
unity-mcp-cli install-extension --list
unity-mcp-cli install-extension Tilemap ./MyUnityProjectEl id puede ser el nombre del catálogo (Tilemap, Cinemachine, ProBuilder, …) o el id del paquete (com.ivanmurzak.unity.mcp.tilemap), sin distinguir mayúsculas y minúsculas. La ruta usa por defecto la carpeta actual. El comando resuelve la última versión de OpenUPM, nunca degrada una versión instalada superior y no hace nada si la extensión ya está actualizada. Fija una versión con --extension-version <version> (no --version, que muestra la versión de la CLI). Abre o enfoca Unity después para que el Package Manager la resuelva.
Instalar con OpenUPM
openupm add com.ivanmurzak.unity.mcp.cinemachineEl README de cada extensión en el repositorio Unity-MCP también enlaza un instalador .unitypackage para esa extensión, que funciona como el instalador principal.
Instalar con la aplicación de escritorio
La app AI Game Dev también puede instalar extensiones de Unity en el proyecto abierto. Usa la versión de OpenUPM propia de cada extensión, que es independiente de la versión del plugin principal. Consulta la documentación de la app.
Después de instalar
- Regenera las skills (Skills > Generate en la ventana, o
unity-mcp-cli setup-skills <agent>) para que la skillunity-rqldel agente incluya el nuevo módulo. - Pide al agente que empiece por
rql-schemasi parece no conocer los nuevos tipos, por ejemplo: "Usa rql-schema para ver qué ofrece la fuente cinemachine y luego añade una cámara de seguimiento para el Player". - Los nombres de herramientas de tutoriales antiguos, como
tilemap-set-tileocinemachine-camera-create, ya no existen. El README de cada extensión los relaciona con su equivalente en RQL.
Actualizar y eliminar
Las extensiones se versionan por separado del plugin principal. Actualízalas en el Package Manager o volviendo a ejecutar install-extension. Elimina una en el Package Manager como cualquier otro paquete. Mantén el plugin principal y las extensiones en versiones actuales a la vez: las extensiones declaran la versión mínima del núcleo que necesitan.
Crear las tuyas propias
El código de tu proyecto puede añadir herramientas directamente (consulta Herramientas personalizadas) o enseñar a RQL tus propios tipos con adaptadores RQL personalizados. La guía de extensiones del repositorio describe cómo se crean y prueban las extensiones oficiales.