Extensões
Extensões do Unity MCP adicionam IA a Animation, Cinemachine, Input System, Navigation, ProBuilder, Splines, Terrain, Tilemap, Timeline e partículas.
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.
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:
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 e, dentro do Editor, em rql-schema.
Instalar pela janela do AI Game Developer
- Abra Window > AI Game Developer — MCP.
- Role até Extensions.
- 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
unity-mcp-cli install-extension --list
unity-mcp-cli install-extension Tilemap ./MyUnityProjectO 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
openupm add com.ivanmurzak.unity.mcp.cinemachineO README de cada extensão no repositório Unity-MCP também traz o link para um instalador .unitypackage daquela extensão, que funciona como o instalador principal.
Instalar com o aplicativo desktop
O aplicativo AI Game Dev 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.
Depois de instalar
- Regenere as skills (Skills > Generate na janela, ou
unity-mcp-cli setup-skills <agent>) para que a skillunity-rqldo agente inclua o novo módulo. - Peça ao agente para começar pelo
rql-schemase 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-tileoucinemachine-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) ou ensinar ao RQL os seus próprios tipos com adaptadores RQL personalizados. O guia de extensões do repositório descreve como as extensões oficiais são criadas e testadas.