Godot Desenvolvimento

Seu assistente de IA que cria jogos completos no Godot — da ideia ao lançamento.

Status Godot Python MCP License Tests Score

📊 Versão: 4.3.0 | Tools: 304 | Blueprints: 50 | Behaviors: 367 | Domínios: 41 ⚠️ Números gerados por scripts/docs_sync.py — não edite manualmente.

---

📑 Índice

• O que é
• ⚡ Comece em 1 minuto
• 🎮 Vitrine de Gêneros (32)
• 📊 Dashboard do Projeto
• 🗺️ Para Contribuidores
• 📂 Estrutura
• 📖 Documentação
• 🔧 Requisitos

---

O que é

O MCP Godot Agent é um servidor MCP em Python que atua como dono do processo de desenvolvimento de um jogo Godot inteiro. Não é só uma ponte entre IA e engine — ele tem travas reais que impedem pular etapas, verificação automatizada e um guia passo a passo.

Para quem é: Pessoas que querem criar um jogo mas não sabem programar. Você descreve o que quer em linguagem natural e a IA constrói.

O que ele faz:

• Cria projetos Godot completos a partir de uma frase
• Gerencia 6 fases de desenvolvimento (Ideia → Design → Protótipo → Conteúdo → Polimento → Pronto)
• Oferece 32 gêneros de jogos prontos para começar
• Verifica cada etapa automaticamente (compilação, testes, smoke test)
• Funciona offline para operações que não dependem de IA

---

� Dashboard do Projeto

Métrica	Valor
Tools ativas	289
Etapas do instalador	14
Testes do instalador	26/26
Behaviors	277
Domínios	41
Clientes IA suportados	3 (VS Code, Claude, Cursor)
Sistemas operacionais	3 (Windows, macOS, Linux)
Fases de desenvolvimento	6
Blueprints de gêneros	29
Godot	4.7.1
Python	3.12+
Score SOTA Instalador	100/100

---

🗺️ Para Contribuidores

Arquivo/Pasta	O que é
.github/copilot-instructions.md	Regras-mestre: o que é o projeto, 5 regras absolutas, teto de ferramentas, padrões técnicos
AGENTS.md	Fluxo de trabalho do agente: comandos /, regras de convivência, o que nunca fazer
HANDOFF.md	Estado atual do projeto ("onde paramos") — atualizado a cada /handoff ou /encerrar
docs/REGISTRY.md	Inventário completo: tools, behaviors, blueprints, addons, fases
docs/sota/	Planejamento estado da arte (7 ondas, 53 fatias)
.github/instructions/	Regras técnicas por tema: aprendizados, camadas 0-7, fontes, autogovernança, behaviors
.github/skills/	Skills sob demanda (glossário, protocolo de pesquisa)
docs/archive/	🗄️ Histórico — versões antigas de prompts, sessões passadas. Não é documentação ativa

---

⚡ Comece em 1 minuto

# Windows: 2 cliques
Abra a pasta INSTALADOR-MCP\ e clique em Instalar.bat

# Ou no terminal:
python -m instalador

📖 Guia completo: INSTALADOR-MCP/LEIA-ME.md

Comandos disponíveis após instalação:

Comando	O que faz
python -m instalador	Instala/configura tudo automaticamente
python -m instalador --so-verificar	Diagnostica sem alterar nada
python scripts/auto-ciclo.py	Ciclo SOTA: audita → corrige → testa
/plan	No Copilot: planeja a próxima etapa do jogo
/handoff	Salva o progresso da sessão
/manual	Manual completo de comandos

Alternativa sem instalador:

git clone https://github.com/joabcostamd/mcp-godot-desenvolvimento
cd mcp-godot-desenvolvimento
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt
.venv\Scripts\python server.py --profile dev

---

🎮 Vitrine de Gêneros (32 gêneros)

Escolha um gênero e comece a criar. Use quickstart_manage(op="showcase") para ver a lista completa.

⭐ Fácil

Gênero	Experimente:
🐍 Snake	"jogo da cobrinha, controle a cobra no grid"
🐦 Flappy Bird	"jogo do passarinho que voa entre canos"
🏓 Pong	"jogo de ping-pong com dois paddles e uma bola"
📈 Doodle Jump	"jogo de pular de plataforma em plataforma subindo"
🧠 Memória	"jogo da memória, vire as cartas e encontre os pares"
🧱 Breakout	"jogo de quebrar tijolos com bola e paddle"
🖱️ Idle Clicker	"jogo de clique incremental, automatize"
🌌 Asteroids	"jogo de nave no espaço, gire e atire"
💣 Campo Minado	"jogo de campo minado, deduza onde estão as minas"

⭐⭐ Médio

Gênero	Experimente:
👾 Space Invaders	"jogo de nave que atira em aliens"
🏃 Endless Runner	"jogo de corrida infinita, desvie dos obstáculos"
🫧 Bubble Shooter	"jogo de atirar bolhas coloridas, forme grupos"
🐸 Frogger	"jogo do sapo, atravesse a rua e o rio"
🎯 Top-Down Shooter	"jogo de nave que atira em asteroides"
🔫 Twin-Stick	"jogo de arena, mova e atire contra waves"
🧊 Tetris	"jogo de encaixar peças que caem"
📦 Sokoban	"jogo de empurrar caixas no grid"
🎮 Plataforma	"jogo de plataforma com pulo e coleta de moedas"
🕹️ Pac-Man	"jogo de labirinto, colete pontos e fuja dos fantasmas"
🧩 Match-3	"jogo de combinar 3 peças coloridas no grid"
🏎️ Corrida	"jogo de corrida visto de cima"
🧲 Puzzle Física	"jogo de puzzle com física realista"

⭐⭐⭐ Avançado

Gênero	Experimente:
🏰 Tower Defense	"jogo de defesa de torre, posicione torres"
🧛 Vampire Survivors	"jogo de sobrevivência com ataque automático"
⚔️ RPG Turno	"RPG de turno, explore o mapa e lute"
🗡️ Dungeon Crawler	"dungeon procedural, explore salas aleatórias"
🃏 Deck Builder	"jogo de cartas estratégico, monte seu deck"
🗺️ Metroidvania	"exploração com plataforma e habilidades"
📖 Visual Novel	"história interativa com diálogos"
💥 Bullet Hell	"jogo de esquiva com dezenas de projéteis"
👊 Beat 'em Up	"jogo de luta de rua, derrote ondas de inimigos"
🥷 Stealth 2D	"jogo de furtividade, evite guardas nas sombras"

---

📂 Estrutura

Pasta/Arquivo	O que é
server.py	Servidor MCP principal (289 ferramentas, stdio JSON-RPC 2.0)
init.py	Instalador de 1 comando (só stdlib, zero dependências)
tools/	240+ módulos Python (cenas, scripts, física, arte, som, pipeline)
resources/	32 padrões de gêneros + 11 prompts MCP
addons/	Plugins Godot (bridge, dock, runtime)
llms.txt	Índice completo do projeto para IAs (padrão llmstxt.org)
docs/REGISTRY.md	Inventário completo do projeto

---

📖 Documentação

Documento	Conteúdo
ROADMAP.md	Progresso das ondas e fatias
AGENTS.md	Regras para agentes de IA no repositório
docs/manual/	Manual do usuário (10 seções, gerado por código)
docs/tutorial/	Tutoriais progressivos (01 a 04)
CHANGELOG.md	Histórico completo de versões

---

🔧 Requisitos

• Python 3.12+
• Godot 4.7
• VS Code + Copilot (ou qualquer cliente MCP)

---

Docs: docs/REGISTRY.md | llms.txt: llms.txt | GitHub: joabcostamd/mcp-godot-desenvolvimento

---

_{Feito com ❤️ por Joab Costa — Reportar Bug · Discussões}