# Extensões — Unity · AI Game Developer Wiki

Extensões do Unity MCP adicionam IA a Animation, Cinemachine, Input System, Navigation, ProBuilder, Splines, Terrain, Tilemap, Timeline e partículas.

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

Extensões são pacotes Unity opcionais que ensinam ao agente de IA recursos específicos do Unity, como câmeras Cinemachine, malhas ProBuilder ou tilemaps 2D. Instale apenas as que o seu projeto usa. Esta página lista as dez extensões oficiais, o que cada uma adiciona e como instalá-la. Cada extensão também tem uma página de detalhes no [catálogo de extensões do Unity](https://ai-game.dev/docs/extensions/unity).

## Como as extensões funcionam

Desde o Unity MCP 1.0.0 (e a versão 2.0.0 da extensão), uma extensão **não adiciona novas ferramentas MCP**. Em vez disso, ela contribui com um **módulo RQL**: novas fontes, funções e adaptadores de tipo que as ferramentas `rql-query` e `rql-mutate` existentes entendem. A lista de ferramentas do agente continua do mesmo tamanho, e o guia da extensão é adicionado à skill `unity-rql` gerada, então o agente aprende a nova sintaxe assim que o pacote é instalado e as skills são regeneradas.

Por exemplo, com o AI Tilemap instalado, o agente pode pintar tiles por meio do RQL:

```text
objects | get components | where $ is Tilemap | call BoxFill("Assets/Tiles/Grass.asset", -5, -3, 5, 3)
```

Cada extensão depende do plugin principal, `com.ivanmurzak.unity.mcp`, e do pacote Unity no qual se baseia. Instalá-la traz os dois. Todas elas suportam Unity 2022.3 e versões mais recentes.

## As extensões oficiais

| Extensão | ID do pacote | Baseia-se em | Adições ao RQL |
| --- | --- | --- | --- |
| AI Animation | `com.ivanmurzak.unity.mcp.animation` | Módulo Animation | fonte `animation`; tipos AnimationClip, AnimatorController e Animator |
| AI Cinemachine | `com.ivanmurzak.unity.mcp.cinemachine` | `com.unity.cinemachine` | fonte `cinemachine`; CinemachineCamera, CinemachineBrain |
| AI InputSystem | `com.ivanmurzak.unity.mcp.inputsystem` | `com.unity.inputsystem` | fonte `input`; InputActionAsset |
| AI Navigation | `com.ivanmurzak.unity.mcp.navigation` | `com.unity.ai.navigation` | fonte `navigation`; NavMeshSurface, NavMeshLink, NavMeshAgent |
| AI Particle System | `com.ivanmurzak.unity.mcp.particlesystem` | Módulo Particle System | ParticleSystem e seus módulos, curvas e gradientes |
| AI ProBuilder | `com.ivanmurzak.unity.mcp.probuilder` | `com.unity.probuilder` | fonte e funções `probuilder`; ProBuilderMesh |
| AI Splines | `com.ivanmurzak.unity.mcp.splines` | `com.unity.splines` | fonte `splines`; SplineContainer |
| AI Terrain | `com.ivanmurzak.unity.mcp.terrain` | Módulos Terrain | fonte `terrain`; funções de altura; Terrain, TerrainData |
| AI Tilemap | `com.ivanmurzak.unity.mcp.tilemap` | Módulo Tilemap e 2D Tilemap Extras | fonte e funções `tilemap`; Tilemap, RuleTile |
| AI Timeline | `com.ivanmurzak.unity.mcp.timeline` | `com.unity.timeline` | fonte `timeline`; TimelineAsset, trilhas, clipes, PlayableDirector |

As fontes, funções e chamadas exatas de cada módulo estão na sua [página do catálogo](https://ai-game.dev/docs/extensions/unity) e, dentro do Editor, em `rql-schema`.

## Instalar pela janela do AI Game Developer

1. Abra **Window > AI Game Developer — MCP**.
2. Role até **Extensions**.
3. Clique em **Install** ao lado da extensão desejada.

A janela adiciona o registro com escopo do OpenUPM e o pacote ao `Packages/manifest.json`, na versão mais recente do OpenUPM. O Unity então resolve e importa o pacote.

## Instalar com unity-mcp-cli

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

O id pode ser o nome no catálogo (`Tilemap`, `Cinemachine`, `ProBuilder`, …) ou o id do pacote (`com.ivanmurzak.unity.mcp.tilemap`), comparado sem diferenciar maiúsculas de minúsculas. O caminho padrão é a pasta atual. O comando resolve a versão mais recente do OpenUPM, nunca faz downgrade de uma versão instalada mais alta e não faz nada se a extensão já estiver atualizada. Fixe uma versão com `--extension-version <version>` (não `--version`, que imprime a versão da CLI). Abra ou focalize o Unity depois, para que o Package Manager o resolva.

## Instalar com o OpenUPM

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

O README de cada extensão no [repositório Unity-MCP](https://github.com/IvanMurzak/Unity-MCP/tree/main/extensions) também traz o link para um instalador `.unitypackage` daquela extensão, que funciona como o [instalador principal](https://ai-game.dev/pt-br/docs/wiki/unity/installation#installer).

## Instalar com o aplicativo desktop

O [aplicativo AI Game Dev](https://ai-game.dev/docs/app) também pode instalar extensões do Unity no projeto aberto. Ele usa a versão OpenUPM de cada extensão, que é independente da versão do plugin principal. Consulte a [documentação do aplicativo](https://ai-game.dev/pt-br/docs/wiki/app).

## Depois de instalar

- Regenere as skills (**Skills > Generate** na janela, ou `unity-mcp-cli setup-skills <agent>`) para que a skill `unity-rql` do agente inclua o novo módulo.
- Peça ao agente para começar pelo `rql-schema` se ele parecer desconhecer os novos tipos, por exemplo: "Use o rql-schema para ver o que a fonte cinemachine oferece e depois adicione uma câmera de acompanhamento para o Player."
- Nomes de ferramentas de tutoriais mais antigos, como `tilemap-set-tile` ou `cinemachine-camera-create`, não existem mais. O README de cada extensão mostra o equivalente em RQL.

## Atualizar e remover

As extensões têm versionamento separado do plugin principal. Atualize-as no Package Manager ou executando `install-extension` novamente. Remova uma no Package Manager como qualquer outro pacote. Mantenha o plugin principal e as extensões em versões atuais em conjunto: as extensões declaram a versão mínima do core de que precisam.

## Escrevendo a sua própria

O código do seu projeto pode adicionar ferramentas diretamente (veja [Ferramentas personalizadas](https://ai-game.dev/pt-br/docs/wiki/unity/custom-tools)) ou ensinar ao RQL os seus próprios tipos com [adaptadores RQL personalizados](https://ai-game.dev/docs/rql/custom-adapters). O [guia de extensões](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/dev/extensions.md) do repositório descreve como as extensões oficiais são criadas e testadas.

## Páginas relacionadas

- [Catálogo de extensões do Unity](https://ai-game.dev/docs/extensions/unity) e [todas as extensões](https://ai-game.dev/docs/extensions).
- [Ferramentas e RQL](https://ai-game.dev/pt-br/docs/wiki/unity/tools-and-rql).

---

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

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