godot-ai

# Godot AI Godot AI conecta clientes MCP como Claude Code, Claude Desktop, Codex e Hermes Agent a um editor Godot ativo. Ele fornece 46 ferramentas e mais de 120 operações que permitem que assistentes de IA construam cenas, editem nós e scripts, conectem sinais e configurem UI, materiais, animação, partículas, câmeras e ambientes. ## Início Rápido ### Requisitos - Godot 4.7+ (dentro da linha 4.x) para Godot AI v4 - uv (fornece uvx para o servidor Python) - Um cliente MCP ### Instalação 1. **Novo projeto:** Baixe uma versão publicada do GitHub Releases e instale o add-on em `seu-projeto/addons/godot_ai/` com `plugin.cfg` dentro desse diretório. 2. **Instalação existente:** Use o botão Atualizar no dock do Godot AI. A versão final assinada v3 suporta migração com um clique para v4. ### Ativar o Plugin No Godot: **Projeto → Configurações do Projeto → Plugins → Godot AI**. O plugin inicia o servidor MCP e mostra o status da conexão no dock do Godot AI. ### Conectar Seu Cliente MCP No dock, pressione **Configurar** ao lado do seu cliente, ou **Configurar todos** para cada cliente detectado. Os clientes suportados incluem Claude Code, Claude Desktop, Codex, Antigravity, Hermes Agent, DeepSeek Harness, Cursor e VS Code. ### Experimente Exemplos de prompts: - "Mostre-me a hierarquia de cena atual." - "Crie uma Camera3D chamada MainCamera sob /Main." - "Pesquise no projeto arquivos PackedScene em ui/." - "Execute a suíte de testes de cena." - "Construa um jogo de mundo de blocos voxel com um jogador, blocos para colocar e destruir, e slots de salvamento." ## Como Funciona ```text Cliente MCP → godot-ai attach (stdio) → Servidor Python (HTTP autenticado, porta 8000) → Plugin do editor Godot (WebSocket autenticado, porta 9500) ``` Ambos os saltos locais usam capacidades rotativas independentes; nenhum recorre a acesso não autenticado. O WebSocket do editor permanece apenas em loopback. Para agentes em contêineres ou outras máquinas, execute a ponte na máquina do editor via SSH. ## Telemetria e Privacidade A telemetria de uso registra um UUID de instalação, evento, resultado, duração, plataforma e versão—não código, conteúdo de cena ou nomes de projeto/arquivo. Slugs de diretório de projeto são hashados antes da transmissão. Opte por sair com `GODOT_AI_DISABLE_TELEMETRY=true` ou `DISABLE_TELEMETRY=true`. ## Documentação e Ajuda ### Problema Bazzite / Fedora Atomic Desktop No Bazzite e outros desktops Fedora Atomic, `/home` é normalmente um link simbólico para `/var/home`. Godot AI 4.0.2 e anteriores recusam todo caminho de diretório de capacidade que passe por um link. A próxima versão segue um link quando ele é de propriedade da raiz e está em um diretório de propriedade da raiz que outras contas não podem escrever. Para 4.0.2 ou anterior, defina `GODOT_AI_CAPABILITY_DIR` para um caminho canônico e inicie tanto o Godot quanto seu cliente MCP a partir desse terminal. ### Referência e Suporte - Ferramentas, operações e recursos - Escreva e execute testes para seu jogo - Detalhes de configuração do cliente - Atualizando da v3 e recuperando migrações interrompidas - Changelog - Contribuindo e configuração de desenvolvimento - Discord para perguntas e demonstrações; GitHub Issues para relatórios de bugs **Licença:** MIT