# Extensões — Unreal Engine · AI Game Developer Wiki

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.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/unreal/extensions).

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](https://github.com/IvanMurzak/Unreal-MCP) e estão listadas na [página de extensões do Unreal](https://ai-game.dev/docs/extensions/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](https://ai-game.dev/pt-br/docs/wiki/unreal/tools#rql)), 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:

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

O comando:

1. Procura o ID da extensão no índice de extensões e encontra sua release mais recente no GitHub.
2. Coloca o plugin em `<project>/Plugins/<PluginName>/` (por exemplo `Plugins/UnrealAINiagara/`).
3. Habilita a extensão e o plugin da engine dela no seu `.uproject`.
4. 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.0` instala uma release exata.
- `--build` compila agora (Windows, macOS e Linux).
- `--source <dir>` instala a partir de uma pasta local, para máquinas offline e CI.
- `--force` reinstala 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-extension` na CLI do app). O app escolhe a release mais recente. Veja [Projetos e engines](https://ai-game.dev/pt-br/docs/wiki/app/projects-and-engines#extensions).

## 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](https://ai-game.dev/pt-br/docs/wiki/unreal/custom-tools).

---

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

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