# Extensiones — Unity · AI Game Developer Wiki

Las extensiones de Unity MCP añaden soporte para Animation, Cinemachine, Input System, Navigation, ProBuilder, Splines, Terrain, Tilemap, Timeline y partículas.

Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/wiki/unity/extensions).

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

```text
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](https://ai-game.dev/docs/extensions/unity) y, dentro del Editor, en `rql-schema`.

## Instalar desde la ventana de AI Game Developer

1. Abre **Window > AI Game Developer — MCP**.
2. Desplázate hasta **Extensions**.
3. 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

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

El 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

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

El README de cada extensión en el [repositorio Unity-MCP](https://github.com/IvanMurzak/Unity-MCP/tree/main/extensions) también enlaza un instalador `.unitypackage` para esa extensión, que funciona como el [instalador principal](https://ai-game.dev/es/docs/wiki/unity/installation#installer).

## Instalar con la aplicación de escritorio

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

## Después de instalar

- Regenera las skills (**Skills > Generate** en la ventana, o `unity-mcp-cli setup-skills <agent>`) para que la skill `unity-rql` del agente incluya el nuevo módulo.
- Pide al agente que empiece por `rql-schema` si 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-tile` o `cinemachine-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](https://ai-game.dev/es/docs/wiki/unity/custom-tools)) o enseñar a RQL tus propios tipos con [adaptadores RQL personalizados](https://ai-game.dev/docs/rql/custom-adapters). La [guía de extensiones](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/dev/extensions.md) del repositorio describe cómo se crean y prueban las extensiones oficiales.

## Páginas relacionadas

- [Catálogo de extensiones de Unity](https://ai-game.dev/docs/extensions/unity) y [todas las extensiones](https://ai-game.dev/docs/extensions).
- [Herramientas y RQL](https://ai-game.dev/es/docs/wiki/unity/tools-and-rql).

---

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

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