# Extensiones — Unreal Engine · AI Game Developer Wiki

Extensiones opcionales de Unreal MCP para Control Rig, Enhanced Input, GAS, Landscape y Water, Niagara y PCG. Qué añade cada una y cómo instalarla.

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

Las extensiones enseñan a Unreal MCP más sistemas del motor. Cada una es un plugin de Unreal independiente y opcional, con su propia versión y release. Instala solo las que use tu proyecto.

Todas las extensiones están en el [repositorio de Unreal-MCP](https://github.com/IvanMurzak/Unreal-MCP) y aparecen en la [página de extensiones de Unreal](https://ai-game.dev/docs/extensions/unreal).

## Cómo funcionan las extensiones

Cada extensión es un **módulo RQL**. No añade herramientas MCP propias. En su lugar, añade fuentes, operaciones y miembros a las herramientas principales `rql-query`, `rql-mutate` y `rql-schema` (consulta [Tools](https://ai-game.dev/es/docs/wiki/unreal/tools#rql)), además de una sección en la skill `unreal-rql` que enseña al agente a usarla. La lista de herramientas del agente se mantiene corta mientras su alcance crece.

La reflexión ya expone las propiedades de cada tipo del motor cargado, así que incluso sin una extensión el agente puede, por ejemplo, asignar el asset de un componente Niagara. Una extensión añade lo que la reflexión no muestra, como listar sistemas Niagara con sus emisores o esculpir un landscape.

## Requisitos

- Unreal Engine **5.7 o posterior** (la suite de pruebas de las extensiones verifica 5.7 y 5.8).
- Unreal MCP **0.26.0 o posterior** en el mismo proyecto.
- Una cadena de herramientas de C++. Las extensiones se distribuyen como código fuente y se compilan para tu proyecto y tu motor.
- El plugin del motor sobre el que se construye cada extensión. El instalador lo activa por ti.

Ninguna extensión necesita otra extensión.

## Las seis extensiones

| Extensión | Id de la extensión | Plugin del motor | Qué añade |
| --- | --- | --- | --- |
| AI ControlRig | `com.ivanmurzak.unreal-ai-control-rig` | ControlRig | Crea rigs con huesos, controles y un solucionador IK de dos huesos; consulta blueprints y componentes de Control Rig |
| AI EnhancedInput | `com.ivanmurzak.unreal-ai-enhanced-input` | EnhancedInput | Consulta Input Actions y Mapping Contexts, crea acciones y contextos, asigna teclas |
| AI GAS | `com.ivanmurzak.unreal-ai-gas` | GameplayAbilities | Consulta clases de habilidades, efectos y attribute sets, y las habilidades otorgadas; otorga habilidades a los actores |
| AI Landscape | `com.ivanmurzak.unreal-ai-landscape` | Water | Crea, esculpe y pinta landscapes; consulta landscapes, masas de agua y zonas de agua |
| AI Niagara | `com.ivanmurzak.unreal-ai-niagara` | Niagara | Consulta sistemas Niagara y sus emisores, coloca sistemas en el nivel |
| AI PCG | `com.ivanmurzak.unreal-ai-pcg` | PCG | Consulta grafos y componentes PCG, añade componentes y ejecuta la generación |

La release actual de cada extensión es la 0.2.0.

### Qué contiene cada módulo RQL

| Extensión | Fuentes | Operaciones |
| --- | --- | --- |
| AI ControlRig | `controlRigs`, `controlRig` | `CreateRig`, `AddBone`, `AddControl`, `AddTwoBoneIK` |
| AI EnhancedInput | `inputActions`, `inputContexts`, `enhancedInput` | `CreateAction`, `CreateContext`, `AddMapping`, `RemoveMapping`, `AddActionEvent`, `AddMappingContextOnBeginPlay` |
| AI GAS | `gasAbilities`, `gasEffects`, `gasAttributeSets`, `gas` | `GrantAbility` |
| AI Landscape | `landscapes`, `waterBodies`, `waterZones`, `landscape` | `Create`, `Sculpt`, `Paint`, `CreateLayerMaterial` |
| AI Niagara | `niagaraSystems`, `niagara` | `SpawnSystem` |
| AI PCG | `pcgGraphs`, `pcg` | `AddComponent`, `Generate` |

No necesitas recordar estos nombres. El agente los lee de `rql-schema` y de la skill. Sirven de ayuda cuando lees las consultas del agente.

## Instalar con unreal-mcp-cli

Cierra primero el Unreal Editor y luego:

```bash
unreal-mcp-cli install-extension com.ivanmurzak.unreal-ai-niagara ./YourProject
```

El comando:

1. Busca el id de la extensión en el índice de extensiones y encuentra su release más reciente en GitHub.
2. Coloca el plugin en `<project>/Plugins/<PluginName>/` (por ejemplo, `Plugins/UnrealAINiagara/`).
3. Activa la extensión y su plugin del motor en tu `.uproject`.
4. Deja la compilación para el siguiente arranque del editor, o compila en el acto con `--build`.

Es seguro ejecutarlo de nuevo: si la misma versión ya está instalada y activada, no cambia nada. Nunca degrada una extensión instalada a menos que pidas una versión concreta.

Flags útiles:

- `--version 0.2.0` instala una release exacta.
- `--build` compila ahora (Windows, macOS y Linux).
- `--source <dir>` instala desde una carpeta local, para máquinas sin conexión y CI.
- `--force` reinstala incluso cuando ya está actualizado.

Puedes instalar por id de extensión, nombre visible o nombre de la carpeta del plugin.

## Instalar desde el editor o desde la app

- **En el editor:** la sección **Extensions** de la ventana de AI Game Developer lista las extensiones instaladas y, tras **Refresh catalog**, las disponibles. **Install** y **Update** descargan la extensión; una extensión nueva muestra «Installed · needs editor restart to compile» hasta que se compila, o usa **Compile (Live Coding)**.
- **En la app AI Game Dev:** usa la acción de extensiones de la barra lateral (o `/install-extension` en la CLI de la app). La app elige la release más reciente. Consulta [Projects and engines](https://ai-game.dev/es/docs/wiki/app/projects-and-engines#extensions).

## Activar o desactivar una extensión

Cada extensión instalada en la sección Extensions tiene un interruptor de activación. Al desactivarlo, sus añadidos desaparecen del agente de inmediato, sin reiniciar el editor. La elección se conserva entre sesiones del editor.

## Ejemplos de prompts

- «Lista todos los sistemas Niagara del proyecto y muestra los emisores de NS\_Fire.» (AI Niagara)
- «Crea una Input Action de tipo booleano IA\_Jump y un Mapping Context IMC\_Default, y asigna la barra espaciadora a la acción.» (AI EnhancedInput)
- «Otorga GA\_Fireball al actor Hero.» (AI GAS)
- «Crea un landscape y píntale una capa de hierba.» (AI Landscape)
- «Añade un componente PCG con PCG\_Forest al actor ForestVolume y genéralo.» (AI PCG)
- «Crea un rig con una cadena de tres huesos y un IK de dos huesos sobre ella.» (AI ControlRig)

## Escribe tu propia extensión

Cualquier plugin de Unreal puede añadir su propio módulo RQL, herramientas, prompts o recursos sin hacer un fork de Unreal MCP. Consulta [Custom tools](https://ai-game.dev/es/docs/wiki/unreal/custom-tools).

---

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

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