CommunityImagengithub.com

kit-de-modelos-para-juegos-en-blender

Crea modelos listos para juegos desde Python en Blender para cualquier motor: kits modulares de niveles (paredes, pisos, puertas, escaleras, plataformas, techos), accesorios y personajes simples. Hornea materiales procedurales a texturas, genera copias LOD económicas y exporta FBX que se integra directamente en Unity u otros motores.

¿Qué es kit-de-modelos-para-juegos-en-blender?

Esta habilidad permite a un agente de IA generar modelos 3D y niveles completos para juegos directamente desde scripts de Python ejecutados en Blender, eliminando la necesidad de modelado manual repetitivo. Está diseñada para desarrolladores que usan herramientas como Claude Code, Cursor o Codex, y soporta tanto ejecución interactiva con el add-on Blender MCP (para visualización en viewport y búsqueda de assets) como ejecución headless mediante `blender -b` para exportaciones reproducibles y sin interferencias de estado de UI. La clave del diseño es un sistema modular basado en una cuadrícula: se definen tamaños de módulos (paredes, pisos, puertas, escaleras) que encajan perfectamente, con pivotes en el centro del piso para que se alineen automáticamente en Unity. El flujo de trabajo incluye funciones helper (`box()`, `cyl()`, `assign`, `finish()`), una función por módulo con parámetros para variantes, unión de partes en un solo mesh con múltiples slots de material para reducir draw calls, horneado de materiales procedurales a texturas (BaseColor, Normal, MetalSmooth, Emission) porque los nodos procedurales no sobreviven la exportación FBX, y exportación con ejes de Unity. Además, se genera un archivo de validación con conteo de triángulos, límites y materiales para detectar regresiones. Se recomienda crear copias `_Lite` para piezas lejanas o repetidas, optimizar presupuestos de triángulos (por ejemplo, disolviendo caras casi coplanares con umbral de 50°), y mantener los scripts y el archivo .blend en control de versiones, tratando el FBX como producto de compilación.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Maimuzamilhu/claude-code-gamedev-pipeline/tree/HEAD/skills/blender-game-kit

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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):

PiezaTamaño
Módulo de pared4.0 m de ancho, 0.12 m de grosor
Piso a techo3.2 m
Baldosa de piso2.0 m
Abertura de puerta1.1 m por 2.2 m
Escalón0.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

  1. Primero las funciones auxiliares: box(), cyl(), assign(material), finish() (aplicar transformaciones, suavizar por ángulo, UVs). Ver scripts/modular_kit.py, un kit funcional pequeño para empezar.
  2. 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).
  3. 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.
  4. Hornea los materiales procedurales (ruido, suciedad, bump) a BaseColor, Normal, MetalSmooth (R = metálico, A = suavidad) y Emission. Los nodos procedurales no sobreviven la exportación FBX; sin horneado, Unity solo ve colores planos.
  5. 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'.
  6. 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 _Lite para 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.json escrito junto al FBX).
  • Mantén el .blend y los scripts en control de versiones. El FBX es un producto de compilación.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados