Esta página foi traduzida automaticamente do inglês. Leia o original em inglês.

Motores · Unity

UnityDisponível

Adicione o plugin AI Game Developer ao seu projeto Unity e controle o Editor com IA.

Unity 2022.3 LTSUnity 2023Unity 6 (6000.x)Qualquer versão 2022.3+
01

Instale o plugin

Duas formas de colocar o plugin no seu projeto — escolha a que combina com seu fluxo de trabalho.

Recomendado

CLI

Instale com a ferramenta unity-mcp-cli. Nada para baixar manualmente — execute os comandos no seu terminal.

1Instalar a CLI

Instale o unity-mcp-cli globalmente via npm.

npm install -g unity-mcp-cli
2Instalar o Unity (opcional)

Instale o Editor Unity usando a CLI. Pule esta etapa se já estiver instalado.

unity-mcp-cli install-unity 6000.3.9f1
3Criar projeto Unity (opcional)

Crie um novo projeto Unity ou use um existente.

unity-mcp-cli create-project ./MyUnityProject
4Instalar plugin

Instale o pacote Unity MCP no seu projeto.

unity-mcp-cli install-plugin ./MyUnityProject
5Abrir projeto Unity

Abra o projeto no Editor Unity.

unity-mcp-cli open ./MyUnityProject

Instalador

Baixe o instalador .unitypackage e importe-o diretamente no seu projeto Unity — uma instalação única e direta.

Baixar .unitypackage
1Instalar o Unity (opcional)

Baixe o Unity Hub e instale qualquer Editor Unity 2022.3 LTS ou mais recente. Pule esta etapa se já estiver instalado.

2Criar projeto Unity (opcional)

Crie um novo projeto Unity com o Unity Hub ou use um existente.

3Baixar instalador

Use o botão Baixar .unitypackage acima para obter AI-Game-Dev-Installer.unitypackage.

4Importar o pacote

No Unity, use Assets → Import Package → Custom Package… e selecione o arquivo baixado.

Prefere um registro de pacotes? Adicione-o pelo OpenUPM: openupm add com.ivanmurzak.unity.mcp. Veja o guia de configuração do plugin Unity para todos os detalhes.

02

Conectar

Conecte pelo endpoint de nuvem hospedado ou aponte para o seu próprio servidor.

Nuvem

Padrão

Conecte pelo ai-game.dev usando o fluxo OAuth de código de dispositivo — sem tokens para copiar à mão. Na janela do AI Game Developer, escolha Cloud, clique em Authorize e aprove o código do dispositivo no navegador. Funciona através de firewalls e oferece análises de uso. É o padrão e o que recomendamos para a maioria dos usuários.

Personalizado

Prefere rodar tudo localmente? Aponte o plugin para a sua própria instância gamedev-mcp-server em vez do endpoint hospedado. Seu cliente de IA passa a falar direto com a sua máquina. Os trechos de configuração de cada cliente estão na página de endpoint MCP.

Precisa de trechos de configuração por cliente (Claude, Cursor, Copilot, Gemini e mais)? Veja a página de endpoint MCP →

03

Configure seu agente de IA

Escolha o agente de IA que você usa e copie o comando unity-mcp-cli exato que o conecta ao servidor MCP do Unity.

Seu agente de IA

Rode isto no seu projeto para configurar Claude Code para Unity:

unity-mcp-cli setup-mcp claude-code ./MyUnityProject

Reinicie seu agente depois de configurar. O novo servidor MCP só é reconhecido em uma reinicialização completa do agente — feche-o por completo e abra de novo (não basta recarregar a janela).

04

Primeira execução

Abra a janela, autorize e teste seu primeiro prompt.

  1. Abra o projeto no Editor Unity e acesse Window → AI Game Developer.
  2. No painel, escolha Cloud e clique em Authorize para concluir o fluxo de código do dispositivo.
  3. Aguarde o indicador de status mostrar Ready (verde) e então conecte seu cliente de IA.
  4. Experimente um prompt como o abaixo a partir do seu cliente de IA e veja a IA agir no Editor.
Prompt de exemplo
Crie uma nova cena com uma luz direcional e um cubo rotativo e entre no modo Play.

Quer mais exemplos de prompts e os padrões para solicitações de IA eficazes? Veja as boas práticas do Unity →

O plugin do Unity expõe 72 recursos (21 ferramentas MCP + RQL) para seu cliente de IA.

Explore o catálogo de ferramentas do Unity →

Quer ainda mais ferramentas? Explore as extensões do Unity →