Unity Generate UI vs Design-to-Engine: Quando Gerar no Editor, Quando Exportar do Canvas

A partir do Unity 6, o Editor adiciona caminhos de linguagem natural / Generate UI para construir telas dentro do projeto (saída típica: UI Toolkit UXML/USS; menus e capacidades exatos variam conforme a versão do Unity—este post não percorre cliques). Muitas equipes também usam Figma / PSD → canvas estruturado do VberStudio → exportação determinística de Prefab (canvas → Prefab, PSD para UGUI). Ambos podem entregar UI, mas o formato do artefato e a manutenção diferem. Misture-os sem limites escritos e você frequentemente obtém: uma tela gerada por IA enquanto as atualizações de reskin alteram apenas o Prefab exportado—a tela gerada se torna órfã.

Abaixo está apenas escolha de pipeline e aceitação (não o tutorial oficial de recursos do Unity): quando Gerar dentro do Editor vs quando manter uma fonte de design + exportação; as regras de Prefab e Play alinham-se com o checklist de engine + MCP e o checklist pré-lançamento.

Godot / Cocos: Não há equivalente no Editor de “descrever a tela inteira” como o Generate UI do Unity. Páginas de ferramentas sem design ainda significam trabalho de cena ou Studio/exportação; design-driven + aceitação de Prefab aplica-se da mesma forma.

Critérios de falha (qualquer um = não aprovado): uma funcionalidade tem duas fontes de UI não rastreáveis (parte da Cena apenas por IA, parte exportada do Studio/Figma, spec omissa); saída do Generate não versionada como Prefab, deixada apenas em uma Cena de teste; divergência de pixel/camada em relação à spec sem isenção por escrito; reskin / multilíngue atualizado em todos os lugares exceto na tela de IA; Raycast / estados de botão em desacordo com o item 5 do handoff e a tela gerada nunca foi aceita por conta própria.

---

Para que serve cada caminho

Dimensão	Unity Editor Generate UI / assistência de IA	Design → canvas Studio → exportação de Prefab
Entrada	Prompt de texto, esboço, contexto de Cena existente	Figma / PSD / divisão de tela inteira
Saída típica	UXML/USS (UI Toolkit); alguns fluxos caem na hierarquia da Cena—ainda assim precisam de Prefab	Prefab UGUI do projeto (ou pilha configurada pelo exportador)
Melhor para	Ferramentas internas, painéis de debug, experimentos de layout	HUD de produção, loja, skins de evento, mesma estrutura entre locales
Fraco para	Arte 1:1 fiel à marca, reskin frequente	Sem fonte de design, spec de tela apenas verbal
Manutenção	Quem é dono das edições UXML/USS; o Generate pode sobrescrever de novo?	Fonte de design + reexportação da árvore completa (i18n, reskin)

Termos: Unity Canvas significa o Canvas UGUI em uma Cena; canvas Studio é a camada intermediária de divisão/exportação do VberAI—não um componente do Unity.

Regra geral: a tela vai mudar de arte com frequência, sofrer reskin ou ser multilíngue → design-driven + exportação determinística primeiro. Única, lógica simples, sem arquivo de design → Generate no Editor é OK, mas ainda Prefab + checklist. Se seu Editor não tem Generate, siga apenas a segunda metade.

---

Quando o Generate é OK (ainda precisa ser aceito)

Use a geração no Editor quando a maior parte disto se aplica—ela não substitui o fluxo de design:

Condição	Notas
Sem frame no Figma/PSD	Ferramentas de planilha, painéis de GM, páginas de configuração temporárias
UI Toolkit permitido	UXML/USS junto com UGUI é documentado; ordem de classificação entre Canvas UGUI e Painel Toolkit na spec
Baixa taxa de mudança	Pouco reskin pós-lançamento; sem dependência de reexportação da árvore completa do Studio
Lógica acima da aparência	Controles padrão OK; sem painéis pesados de nine-slice

Após o Generate (6 passos):

1. Prefab no VCS — não apenas uma Cena de teste (item 6 do pré-lançamento).
2. Política de uma única pilha de UI — se o HUD principal é UGUI, marque telas Toolkit como exceções na spec para evitar caos de EventSystem / input.
3. Raycast e estados de botão — mesma régua dos itens 7–8 do checklist MCP.
4. Safe Area / Scaler — mesma linha de base do HUD global (QA de Safe Area).
5. Locales — se a tela é multilíngue, substitua o texto gerado por tabelas de strings + smoke de idioma de estresse; geração ≠ texto final.
6. MCP para lógica — casca do Generate; checklist MCP para Play—“gerado” ≠ clicável ou com estado correto.

---

Quando o Generate não pode substituir design-to-engine

Sinal	Use em vez disso
Figma/PSD completo, precisa 1:1	Figma → Unity ou pipeline PSD; Generate apenas para rascunhos pessoais
Reskin de evento, mesma estrutura por locale	Cadeia Studio / exportação; telas geradas não entram em lote com reskin
Arte fatiada / HUD com bitmap-font	Nine-slice, números de dano precisam de spec de arte; Generate raramente garante insets/fontes
Sem LLM editando YAML de Prefab	Igual a canvas para engine: mudanças estruturais via exportação determinística, não edições do gerador no YAML do repositório

---

Roteamento de correções

Sintoma	Causa provável	Ação	Responsável
Uma tela antiga após reskin	Apenas Generate, não está na fonte de design	Adicionar frame de design, aceitar Toolkit permanente, ou reexportar substituindo	Eng + design
Locales quebram só na tela gerada	Strings hard-coded	Tabelas de strings ou exportação de tradução	Eng + loc
Cliques conflitam com HUD UGUI	Mistura Toolkit/UGUI não documentada	Unificar módulo de input ou separar Canvas	Eng
Generate sobrescreveu edições manuais	Re-Generate do mesmo UXML	Congelar Prefab; corrigir manualmente no VCS	Eng
Aparência errada vs mock	Generate usado para UI de produção	Figma/PSD → Prefab	Design + eng

---

FAQ

Generate UI é o mesmo que Cursor editando Prefabs?
Não. Generate constrói estrutura de UI no Editor; Cursor + MCP serve para vinculação de referências e smoke de Play. Nenhum substitui o checklist de handoff de design ou a exportação determinística.

Projeto todo UGUI—ainda usar Generate?
Sim, como pilha de exceção documentada no README/spec; caso contrário o QA aplica as réguas de UGUI a telas Toolkit.

Tela de protótipo na build de produção?
Se for lançada, Prefab + checklist pré-lançamento; senão #if DEVELOPMENT_BUILD ou Cena isolada—não misture no HUD principal.

VberStudio vs Unity Generate—escolher um?
Não. O Studio é design → canvas Studio → Prefab; Generate é UI rápida sem arte dentro do projeto. Telas de produção favorecem Studio/exportação; Generate preenche páginas de ferramentas sem design.

Sem Generate UI na nossa versão do Unity?
Pule o ramo Generate; design-to-engine + seis passos de aceitação + tabela de correções ainda se aplicam. Equipes Godot/Cocos usam a mesma regra: arte → exportação; sem arte → Prefab + aceitação.