Kit de jogos Blender (modelos a partir de código)
Construa o mundo do jogo a partir de scripts Python executados no Blender. Uma masmorra, uma casa, uma estação espacial, um quarteirão: tudo são módulos em uma grade mais props. Uma alteração é uma edição e uma reexecução, nunca horas de remodulação.
Exemplo (HOLD STILL): toda a fábrica de dois andares (paredes, pisos, portas, escadas, móveis de laboratório, robôs, detritos) veio de cerca de 20 scripts do Blender.
Como o agente executa o Blender
- Blender vivo (add-on Blender MCP): execute Python no Blender aberto do usuário, visualize a viewport, pesquise e importe assets do Poly Haven / Sketchfab. Melhor para explorar e verificar a aparência.
- Headless (para a exportação real):
blender -b --factory-startup -P build_kit.py. Mesmo resultado a cada execução, sem vazamento de estado da interface. Use isso para qualquer coisa que o jogo distribua.
Consulte os nós de shader pelo tipo, nunca pelo nome (os nomes são traduzidos em outras línguas da interface):
next(n for n in mat.node_tree.nodes if n.type == "BSDF_PRINCIPLED").
A grade é o design
Escolha os tamanhos dos módulos primeiro e nunca os quebre. Combine-os com seu personagem: portas um pouco mais largas e altas que a cápsula do jogador, degraus mais baixos que a altura do passo dele. Um bom ponto de partida para um personagem de tamanho humano (estes são os números do HOLD STILL):
| Peça | Tamanho |
|---|---|
| Módulo de parede | 4,0 m de largura, 0,12 m de espessura |
| Piso ao teto | 3,2 m |
| Laje de piso | 2,0 m |
| Abertura de porta | 1,1 m por 2,2 m |
| Degrau de escada | 0,18 m de altura (mantenha abaixo da altura do passo do personagem) |
Pivô no centro do piso do módulo para que as peças se encaixem em metros inteiros na Unity.
Fluxo de trabalho
- Primeiro os auxiliares:
box(),cyl(),assign(material),finish()(aplicar transformações, suavizar por ângulo, UVs). Vejascripts/modular_kit.py, um pequeno kit funcional para começar. - Uma função por módulo (
build_wall,build_floor,build_doorway). Parâmetros para variantes (com ou sem dreno, faixa de perigo, janela). - Uma malha por módulo, muitos slots de material. Junte as partes. Cada módulo se torna um objeto e um conjunto de texturas: menos chamadas de desenho.
- Converta (bake) materiais processuais (ruído, sujeira, bump) para
BaseColor,Normal,MetalSmooth(R = metálico, A = suavidade) eEmission. Nós processuais não sobrevivem à exportação FBX; sem a conversão, a Unity vê apenas cores planas. - Exporte FBX com os eixos da Unity:
axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'. - Escreva um arquivo de validação após a exportação: por módulo, contagem de triângulos, limites, contagem de materiais. Compare com a execução anterior para que regressões apareçam como números.
Orçamentos de triângulos (o que importou)
- Conte onde os triângulos vão antes de otimizar. Exemplo: no HOLD STILL, três lajes de teto eram 38,6% de todos os triângulos na cena por causa de chanfros de 2 mm que ninguém vê de 2 m abaixo. Uma decimação planar (dissolver faces quase coplanares, 50 graus, delimitada por costuras UV e material) reduziu-os drasticamente sem alteração visível. Veja
references/budgets.md. - Chanfros pequenos são para props de herói de perto, não para módulos repetidos.
- Crie cópias
_Litepara peças distantes ou repetidas em vez de editar o kit de origem.
Entrega para a Unity
- Configurações de importação: gere colisores apenas nas peças que o jogador toca; use colisores de caixa simples para o resto.
- Vincule as texturas convertidas a um material Lit URP por módulo pelo nome (um pequeno script de editor que lê um
materials.jsonescrito ao lado do FBX). - Mantenha o
.blende os scripts no controle de versão. O FBX é um produto de compilação.