Kit de modelos para juegos en Blender (modelos desde código)
Construye el mundo del juego desde scripts de Python ejecutados en Blender. Una mazmorra, una casa, una estación espacial, una manzana de ciudad: todo son módulos en una cuadrícula más accesorios. Un cambio es una edición y una re-ejecución, nunca horas de remodelado.
Ejemplo (HOLD STILL): toda la fábrica de dos pisos (paredes, pisos, puertas, escaleras, mobiliario de laboratorio, robots, escombros) surgió de unos 20 scripts de Blender.
Cómo ejecuta el agente Blender
- Blender en vivo (add-on Blender MCP): ejecuta Python en el Blender abierto del usuario, mira el viewport, busca e importa assets de Poly Haven / Sketchfab. Mejor para explorar y verificar apariencias.
- Headless (para la exportación real):
blender -b --factory-startup -P build_kit.py. Mismo resultado cada ejecución, sin que el estado de la interfaz se filtre. Usa esto para cualquier cosa que se incluya en el juego.
Busca nodos de shader por tipo, nunca por nombre (los nombres se traducen en otros idiomas de interfaz):
next(n for n in mat.node_tree.nodes if n.type == "BSDF_PRINCIPLED").
La cuadrícula es el diseño
Elige primero los tamaños de los módulos y nunca los rompas. Ajústalos a tu personaje: puertas un poco más anchas y altas que la cápsula del jugador, escalones más bajos que su altura de paso. Un buen punto de partida para un personaje de tamaño humano (estos son los números de HOLD STILL):
| Pieza | Tamaño |
|---|---|
| Módulo de pared | 4.0 m de ancho, 0.12 m de grosor |
| Piso a techo | 3.2 m |
| Baldosa de piso | 2.0 m |
| Abertura de puerta | 1.1 m por 2.2 m |
| Escalón | 0.18 m de altura (mantenlo por debajo de la altura de paso del personaje) |
Pivote en el centro del piso del módulo para que las piezas encajen en metros enteros en Unity.
Flujo de trabajo
- Primero las funciones auxiliares:
box(),cyl(),assign(material),finish()(aplicar transformaciones, suavizar por ángulo, UVs). Verscripts/modular_kit.py, un kit funcional pequeño para empezar. - Una función por módulo (
build_wall,build_floor,build_doorway). Parámetros para variantes (con o sin desagüe, franja de peligro, ventana). - Un mesh por módulo, muchos slots de material. Une las partes. Cada módulo se convierte en un objeto y un conjunto de texturas: menos draw calls.
- Hornea los materiales procedurales (ruido, suciedad, bump) a
BaseColor,Normal,MetalSmooth(R = metálico, A = suavidad) yEmission. Los nodos procedurales no sobreviven la exportación FBX; sin horneado, Unity solo ve colores planos. - Exporta FBX con los ejes de Unity:
axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'. - Escribe un archivo de validación después de la exportación: por módulo, conteo de triángulos, límites, cantidad de materiales. Compáralo con la ejecución anterior para que las regresiones aparezcan como números.
Presupuestos de triángulos (lo que importó)
- Cuenta dónde van los triángulos antes de optimizar. Ejemplo: en HOLD STILL, tres losetas de techo eran el 38.6% de todos los triángulos en la escena debido a biseles de 2 mm que nadie ve desde 2 m de distancia. Una decimación planar (disolver caras casi coplanares, 50 grados, delimitada por costuras UV y material) las redujo drásticamente sin cambios visibles. Ver
references/budgets.md. - Los biseles pequeños son para accesorios de primer plano, no para módulos repetidos.
- Haz copias
_Litepara piezas lejanas o repetidas en lugar de editar el kit original.
Transferencia a Unity
- Configuración de importación: genera colisionadores solo en las piezas que el jugador toca; usa colisionadores de caja simples para el resto.
- Vincula las texturas horneadas a un material URP Lit por módulo según el nombre (un pequeño script de editor que lee un
materials.jsonescrito junto al FBX). - Mantén el
.blendy los scripts en control de versiones. El FBX es un producto de compilación.