Extensões
Extensões opcionais do Unreal MCP para Control Rig, Enhanced Input, GAS, Landscape e Water, Niagara e PCG. O que cada uma adiciona e como instalar.
As extensões ensinam ao Unreal MCP mais sistemas da engine. Cada uma é um plugin Unreal separado e opcional, com versão e release próprias. Instale apenas as que seu projeto usa.
Todas as extensões ficam no repositório Unreal-MCP e estão listadas na página de extensões do Unreal.
Como as extensões funcionam
Cada extensão é um módulo RQL. Ela não adiciona ferramentas MCP próprias. Em vez disso, adiciona fontes, operações e membros às ferramentas principais rql-query, rql-mutate e rql-schema (veja Ferramentas), além de uma seção na skill unreal-rql que ensina o agente a usá-la. A lista de ferramentas do agente continua curta enquanto seu alcance cresce.
A reflexão já expõe as propriedades de todo tipo de engine carregado, então mesmo sem uma extensão o agente pode, por exemplo, definir o asset de um componente Niagara. Uma extensão adiciona o que a reflexão não mostra, como listar sistemas Niagara com seus emissores ou esculpir um landscape.
Requisitos
- Unreal Engine 5.7 ou mais recente (a suíte de testes das extensões verifica 5.7 e 5.8).
- Unreal MCP 0.26.0 ou mais recente no mesmo projeto.
- Um conjunto de ferramentas C++. As extensões são distribuídas como código-fonte e compiladas para seu projeto e sua engine.
- O plugin da engine no qual cada extensão se baseia. O instalador o habilita para você.
Nenhuma extensão precisa de outra extensão.
As seis extensões
| Extensão | ID da extensão | Plugin da engine | O que adiciona |
|---|---|---|---|
| AI ControlRig | com.ivanmurzak.unreal-ai-control-rig | ControlRig | Crie rigs com bones, controles e um solver de IK de dois bones; consulte blueprints e componentes de Control Rig |
| AI EnhancedInput | com.ivanmurzak.unreal-ai-enhanced-input | EnhancedInput | Consulte Input Actions e Mapping Contexts, crie actions e contexts, mapeie teclas |
| AI GAS | com.ivanmurzak.unreal-ai-gas | GameplayAbilities | Consulte classes de ability, effect e attribute set e as abilities concedidas; conceda abilities a actors |
| AI Landscape | com.ivanmurzak.unreal-ai-landscape | Water | Crie, esculpa e pinte landscapes; consulte landscapes, corpos d'água e zonas de água |
| AI Niagara | com.ivanmurzak.unreal-ai-niagara | Niagara | Consulte sistemas Niagara e seus emissores, posicione sistemas no nível |
| AI PCG | com.ivanmurzak.unreal-ai-pcg | PCG | Consulte grafos e componentes PCG, adicione componentes e execute a geração |
A release atual de cada extensão é a 0.2.0.
O que cada módulo RQL contém
| Extensão | Fontes | Operações |
|---|---|---|
| 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 |
Você não precisa memorizar esses nomes. O agente os lê de rql-schema e da skill. Eles ajudam quando você lê as consultas do agente.
Instalar com o unreal-mcp-cli
Feche o Unreal Editor primeiro, depois:
unreal-mcp-cli install-extension com.ivanmurzak.unreal-ai-niagara ./YourProjectO comando:
- Procura o ID da extensão no índice de extensões e encontra sua release mais recente no GitHub.
- Coloca o plugin em
<project>/Plugins/<PluginName>/(por exemploPlugins/UnrealAINiagara/). - Habilita a extensão e o plugin da engine dela no seu
.uproject. - Deixa a compilação para a próxima inicialização do editor, ou compila imediatamente com
--build.
É seguro executar de novo: se a mesma versão já estiver instalada e habilitada, nada muda. Ele nunca faz downgrade de uma extensão instalada, a menos que você peça uma versão.
Flags úteis:
--version 0.2.0instala uma release exata.--buildcompila agora (Windows, macOS e Linux).--source <dir>instala a partir de uma pasta local, para máquinas offline e CI.--forcereinstala mesmo quando já está atualizado.
Você pode instalar pelo ID da extensão, pelo nome de exibição ou pelo nome da pasta do plugin.
Instalar pelo editor ou pelo app
- No editor: a seção Extensions da janela do AI Game Developer lista as extensões instaladas e, após Refresh catalog, as disponíveis. Install e Update baixam a extensão; uma nova extensão mostra "Installed · needs editor restart to compile" até ser compilada, ou use Compile (Live Coding).
- No app AI Game Dev: use a ação de extensões da barra lateral (ou
/install-extensionna CLI do app). O app escolhe a release mais recente. Veja Projetos e engines.
Ativar ou desativar uma extensão
Cada extensão instalada na seção Extensions tem um botão de ativação. Desativá-la remove suas adições do agente imediatamente, sem reiniciar o editor. A escolha é mantida entre sessões do editor.
Exemplos de prompts
- "Liste todos os sistemas Niagara do projeto e mostre os emissores de NS_Fire." (AI Niagara)
- "Crie uma Input Action booleana IA_Jump e um Mapping Context IMC_Default, e mapeie a barra de espaço para ele." (AI EnhancedInput)
- "Conceda GA_Fireball ao actor Hero." (AI GAS)
- "Crie um landscape e pinte uma camada de grama nele." (AI Landscape)
- "Adicione um componente PCG com PCG_Forest ao actor ForestVolume e gere-o." (AI PCG)
- "Crie um rig com uma cadeia de três bones e um IK de dois bones nele." (AI ControlRig)
Escreva sua própria extensão
Qualquer plugin Unreal pode adicionar seu próprio módulo RQL, ferramentas, prompts ou recursos sem fazer fork do Unreal MCP. Veja Ferramentas personalizadas.