Scripts Compilam mas a Hierarquia Está Errada? Checklist de Handoff de UI para Game Dev e MCP

No desenvolvimento indie e de pequenas equipes, o bloqueio habitual não é “não consigo escrever C# / GDScript”—é que os scripts compilam, abre-se a Scene e nada se alinha: botões não recebem cliques.

A causa raiz raramente é um modelo de IA fraco. É misturar handoff da casca de UI e lógica de gameplay na mesma toolchain. Abaixo: modos de falha comuns, um checklist de aceitação e onde o Engine MCP (Unity MCP / Godot MCP / Cocos MCP) deve entrar no pipeline.

---

Duas tarefas—não force uma única ferramenta de IA a fazer as duas

Tarefa	Saída típica	Ferramenta melhor
Casca de UI	Árvore Canvas / Control, Prefab, âncoras, nomenclatura de slices	Import estruturado de design (PSD / Figma → engine)
Lógica de gameplay	Eventos de botão, stats, máquinas de estado, debug no Play	Cursor / Claude Code + Engine MCP

Cursor, Copilot, Claude Code por padrão veem o texto do repositório. Eles não veem:

• Edições não salvas da scene no editor
• Seleção atual, referências de prefab quebradas
• Console e estado transitório de UI em modo Play

Então a IA corrige o .cs enquanto Btn_Start continua sem OnClick na Hierarchy—isso não é problema de prompt, é ponte de editor ausente. O MCP preenche essa lacuna. Mapa da categoria: Ferramentas de IA para Godot / Unity.

---

Após importar UI: 10 verificações de engenharia

Depois que o design ou o Studio exporta um Prefab, execute isto antes do primeiro Play (exemplos em Unity UGUI; Godot / Cocos mapeiam de forma semelhante):

#	Verificação	Falha comum
1	Canvas / Control raiz e política de resolução	Canvas Scaler errado; Safe Area retrato cortada
2	Área de clique separada da decoração	Imagem transparente bloqueia Raycast
3	Botão normal / pressionado / desabilitado	Apenas uma imagem estática
4	Texto mapeia para TMP / Label	Tipo de exibição em tela cheia, sem localização
5	Nomes de nós amigáveis a script (Btn_*, Panel_*)	Layer 47 copy
6	Regras de âncora / 9-slice e esticamento	Layout desvia ao mudar resolução
7	Atlas e draw calls aceitáveis	Um PNG superdimensionado por controle
8	Caminhos de import batem com convenções do projeto	MCP não encontra o caminho do Prefab
9	Commit antes de ligar a lógica	IA edita script; referências caem
10	Play uma vez em 16:9 e no retrato alvo	Testado só no aspecto da janela do Editor

Import estruturado vs slice manual: Figma → Unity sem fatiamento manual, divisão de UI in-place.

---

Quando instalar o Engine MCP

Situação	Recomendação
Mudanças diárias de gameplay, Play / Console frequentes	Instale o Engine MCP correspondente
UI ainda reconstruída por slice manual toda semana	Corrija a casca primeiro (Studio / handoff de spec), depois MCP
Apenas scripts, raramente toca na Scene	Benefício limitado do MCP
Game Jam, jogável no mesmo dia	Studio para UI + MCP para botões (passo a passo)

Godot MCP é open source—bom para validar o fluxo primeiro: instalar · quando manual vs MCP. Unity / Cocos: pacotes Pro oficiais—instalar Unity MCP · Cocos 3.x.

Escolha entre três engines: Godot MCP vs Unity MCP vs Cocos MCP.

---

Divisão recomendada (visão de engenharia)

Arquivo de design / arte de UI em tela cheia
 → AI Studio: importar · dividir · exportar Prefab (Unity / Godot / Cocos)
 → Engenharia executa as 10 verificações acima
 → Cursor + Engine MCP: ligar OnClick, HUD, stats, debug no Play

Tipo de mudança	Rota
Troca de tema / texto localizado / reskin de tela cheia	Re-export do Studio (reskin, traduzir)
Sensação, colisão, IA, saves, bugs	MCP + código revisado à mão
Números de dano, fonte pixel	Fonte bitmap ou TMP

Regra geral: Studio para a casca, MCP para a fiação. Não peça ao MCP para construir um HUD inteiro do zero; não escreva a FSM de combate dentro da ferramenta de canvas.

---

Depois que o MCP está ligado: 3 práticas

1. Prompts precisam ser verificáveis—caminho do Prefab.
2. Commits pequenos—uma mudança por vez: “Botão Start → carregar fase,” depois IA de inimigos.
3. MCP não substitui QA—edições de nós geradas por modelo ainda precisam de Play; economiza cliques.

Cursor e Claude Code com Unity: guia de fluxo Unity MCP, Claude Code conecta Unity MCP.

Combinação de ferramentas e rollout de uma semana: eficiência de IA em game dev 2026.

FAQ

Cursor basta—preciso do MCP? Basta para scripts; quando você mexe na árvore da Scene.

O MCP pode substituir o fatiamento de UI? Não. O MCP gerencia objetos dentro do editor; a estrutura de UI ainda precisa de handoff em nível de Prefab (Studio ou fluxo de spec PSD / Figma).

Só uma engine—ainda vale aprender o Studio? Vale se revisões de UI consomem tempo reconstruindo o Canvas; se a UI é mínima.

Projeto pequeno em Godot—instalar o quê primeiro? Experimente o Godot MCP (open source) primeiro; adicione o AI Studio quando o handoff de UI doer.

Conflita com o Unity AI UI Generator? Sem conflito. O Unity AI pende para sprites do editor; para multi-engine ou import estruturado de PSD/Figma.