Extensiones
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.
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 y aparecen en la página de extensiones de 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), 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:
unreal-mcp-cli install-extension com.ivanmurzak.unreal-ai-niagara ./YourProjectEl comando:
- Busca el id de la extensión en el índice de extensiones y encuentra su release más reciente en GitHub.
- Coloca el plugin en
<project>/Plugins/<PluginName>/(por ejemplo,Plugins/UnrealAINiagara/). - Activa la extensión y su plugin del motor en tu
.uproject. - 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.0instala una release exacta.--buildcompila ahora (Windows, macOS y Linux).--source <dir>instala desde una carpeta local, para máquinas sin conexión y CI.--forcereinstala 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-extensionen la CLI de la app). La app elige la release más reciente. Consulta Projects and engines.
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.