Communitygithub.com

ultimate-blender

Habilidad integral para Blender 5.x que cubre modelado, esculpido, retopología/UV, PBR, horneado, rigging, animación, simulaciones, VFX, iluminación, renderizado, exportación para juegos, mesas giratorias de producto, Poly Haven, foto a 3D y más de 90 estilos artísticos. Controla Blender mediante blender-mcp o CLI sin cabeza.

¿Qué es ultimate-blender?

Ultimate Blender es una habilidad unificada basada en el flujo de trabajo Director: ANALIZAR → PLANIFICAR → BRIEF → EJECUTAR → VALIDAR → ENTREGAR. Combina guías de tres paquetes fuente (el4cteo, arjun988, kevinbadi) en una sola estructura, proporcionando reglas actualizadas para Blender 5.x, énfasis en API de datos sobre operadores, y más de 90 estilos artísticos organizados por tipo (arte, horror, mundos/estados de ánimo, géneros de juego). Admite ejecución en vivo a través de blender-mCP (llamadas pequeñas con importaciones namespace-fresh) o modo sin cabeza mediante scripts de shell que invocan `run_in_blender.py`. Incluye scripts empaquetados para tareas comunes (QA, estadísticas de malla, horneado, exportación, etc.) y nodos Node.js para funcionalidades adicionales como exportación a Three.js. La habilidad es útil para cualquier desarrollador o ingeniero de IA que necesite automatizar tareas complejas de Blender en producción, asegurando consistencia, validación y entrega optimizada para plataformas como Unity, Unreal, Godot, Roblox y web.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/i-smiling-buddha/blender-animation-skill/tree/HEAD/skills/ultimate-blender

Preguntar en tu IA favorita

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

Documentación

Ultimate Blender

Una habilidad que fusiona tres paquetes: el4cteo (scripts bpy probados + reglas de Blender 5.x), arjun988 (flujo de trabajo de Director Técnico de Arte, más de 90 guías de especialistas y estilos) y kevinbadi (animaciones de cámara para productos, Poly Haven, Meshy foto a 3D, exportación a Three.js).

Cómo usar este archivo: léelo primero, luego abre solo la(s) guía(s) de la tabla de enrutamiento que coincida(n) con la tarea. No cargues todas las guías. Cada guía tiene secciones de todos los paquetes fuente para ese tema. Todas las rutas son relativas a la carpeta de esta habilidad (<skill_root>).

1. Flujo de trabajo del Director (para cada nuevo activo)

ANALIZAR → PLANIFICAR → BRIEF → EJECUTAR → VALIDAR → ENTREGAR
  1. Analizar: propósito del activo (héroe / estándar / fondo), destino (juego / cinemática / portafolio / video de producto), plataforma (móvil / consola / PC / web / Roblox), estilo, animación (estático / riggeado / animado), formato de exportación.
  2. Planificar: elige las guías de la tabla de enrutamiento (sección 4) y establece los presupuestos de polígonos y texturas (refs/shared/polycount-budgets.md).
  3. Brief: para cualquier cosa más grande que una edición rápida, escribe un breve brief de producción antes de tocar Blender: activo, presupuestos, guías utilizadas, fases, destino de exportación.
  4. Ejecutar: realiza pequeños pasos a través de MCP o sin cabeza (sección 2). Usa los scripts incluidos antes de escribir código nuevo.
  5. Validar: sigue la sección 5. Este paso es obligatorio.
  6. Entregar: exporta, luego informa números y rutas de archivo.

¿Imagen de referencia adjunta? Sigue refs/shared/reference-image-match.md: completa refs/shared/reference-analysis-template.md, empareja la cámara antes de los microdetalles, itera sobre comparaciones de capturas de pantalla, luego verifica contra refs/shared/visual-match-checklist.md. Manual completo del Director, con briefs, recetas multi-habilidad y árboles de decisión: refs/director-full.md. Nomenclatura: refs/shared/naming-conventions.md · Pipeline: refs/shared/asset-pipeline.md · MCP: refs/shared/mcp-integration.md, refs/shared/mcp-tools.md.

2. Ejecutar

En vivo (blender-mcp execute_blender_code): trabaja en pasos pequeños e imprime solo lo que necesitas. Para llamar a un script incluido:

import sys, importlib; sys.path.insert(0, r"<skill_root>/scripts")
import qa_check; importlib.reload(qa_check); print(qa_check.run(objects=["Chair"]))

Cada llamada MCP se ejecuta en un espacio de nombres nuevo, así que vuelve a import cada vez. Usa reload solo después de editar un script.

Sin cabeza (shell, no necesita MCP). Esto imprime solo el JSON del script:

python <skill_root>/scripts/run_in_blender.py --blend in.blend <skill_root>/scripts/<script.py> -- --objects Chair --save out.blend
python <skill_root>/scripts/run_in_blender.py --expr "import bpy; print(len(bpy.data.objects))"

Windows: prefiere PowerShell. En Git Bash, antepone MSYS_NO_PATHCONV=1 y usa $(cygpath -m ~/.claude/skills)/ultimate-blender/.... blender.exe debe estar en PATH, o pasa su ruta. Primera llamada en una sesión: ejecuta scripts/env_report.py (versión, motores, GPU, complementos, unidades, gestión de color). Ayudantes de Node (kevinbadi; se comunican con blender-mcp en el puerto 9876): node <skill_root>/scripts/node/<name>.js --help.

3. Reglas de Blender 5.x (estas anulan consejos anteriores en cualquier guía)

  • API de datos sobre operadores: usa bpy.data, bmesh, mesh.attributes y foreach_get/set con numpy. Los operadores necesitan contexto, y el modo sin fondo no tiene vista 3D.
  • Operador inevitable: with bpy.context.temp_override(object=ob, active_object=ob, selected_objects=[ob], selected_editable_objects=[ob]): bpy.ops..., luego verifica {'FINISHED'}.
  • Modo Edición: ob.data queda obsoleto mientras se está en Modo Edición. Usa bmesh.from_edit_mesh + update_edit_mesh, o cambia primero al modo OBJETO.
  • Nodos: búscalos por type ("BSDF_PRINCIPLED"), nunca por name, porque los nombres están localizados.
  • Enums: léelos desde bl_rna.properties[p].enum_items. Para enums dinámicos (render.engine, view_transform), asigna dentro de try/except TypeError.
  • Motores: BLENDER_EEVEE, CYCLES, BLENDER_WORKBENCH. GPU: scene.cycles.device="GPU" + las preferencias compute_device_type.
  • Malla evaluada: ob.evaluated_get(dg).to_mesh(), luego siempre to_mesh_clear(). Llama a view_layer.update() antes de leer matrix_world.
  • Datos liberados: recopila nombres antes de eliminar o aplicar cualquier cosa, y nunca reutilices la referencia antigua de Python.
  • Nombres: nunca confíes en "Cube.001". Renombra explícitamente y busca objetos con bpy.data.objects[name].
  • Escala: 1 unidad = 1 m. Aplica rotación y escala antes de biselados, rigging, física, horneado y exportación.
  • Las sesiones en vivo son el trabajo del usuario: nunca uses read_factory_settings, nunca elimines datos que no creaste, y guarda una copia de seguridad (save_as_mainfile(copy=True)) antes de ediciones por lotes destructivas.
  • GPU en segundo plano: llama a gpu.init() (5.2+). bgl ya no existe. El modo Esculpido falla en -b, así que usa scripts/sculpt_ops.py.
  • Roturas de API 5.x: action.fcurves → channelbags · scene.node_tree → scene.compositing_node_group · material.use_nodes obsoleto · mod["Socket_2"] → mod.properties.inputs.Socket_2.value · BLENDER_EEVEE_NEXT → BLENDER_EEVEE · Booleano FAST → FLOAT · capas de hueso → colecciones de huesos · bl_info → blender_manifest.toml · 5.3: pila de efectos del compositor, EXPAND de VSE → RIPPLE. Tabla completa: refs/blender-core/api-changes-5x.md. Patrones de código: refs/blender-core/bpy-patterns.md.

4. Enrutamiento: tarea → guía (+ scripts)

TareaAbrirScripts clave
Unidades, nomenclatura, colecciones, bibliotecas de activos, pipelines por lotes/sin cabeza, complementos/extensionesguides/01-scene-pipeline.mdscene_audit, batch_process, assets/addon_template
Superficie dura, biselados, booleanos, normales ponderadas, modelado general, modelado proceduralguides/02-modeling-hardsurface.mdapply_stack
Props, kitbash, muebles, vehículos, mechs, archvizguides/03-props-vehicles-archviz.mdapply_stack, build_pbr_material
Esculpido, multires, remesh, criaturas, monstruosguides/04-sculpting-creatures.mdsculpt_ops
Personajes humanos, arquetipos, ropa, rig facial, ARKit / visemasguides/05-characters-clothing-face.mdgarment, shapekeys
Cabello, pelaje, tarjetas de cabelloguides/06-hair-groom.mdgroom
Retopología, despliegue UV, densidad de texel, UDIM, UV de lightmapguides/07-retopology-uv.mdauto_retopo, uv_pack, texel_density
Materiales PBR, desgaste y suciedad, calcomanías, hojas de recorte, horneadoguides/08-materials-texturing-baking.mdbuild_pbr_material, smart_material, decal, bake_maps
Nodos de geometría, generadores procedurales, dispersiónguides/09-geometry-nodes.mdgn_builder
Terreno, biomas, kits modulares, vegetación, ambientación de escenaguides/10-environments-vegetation.mdterrain, scatter, kit_check
Rigify, skinning, esqueletos de juego, keyframes, NLA, retarget de mocap, buclesguides/11-rigging-animation.mdrigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check
Cuerpo rígido, tela, fluidos, destrucción, VFX, lluvia, nieve, relámpagosguides/12-simulation-vfx-weather.mdsim_setup, precipitation, surface_weather, lightning
Rigs de iluminación, HDRI, look-dev, cámara, hora del día, niebla, estados de ánimoguides/13-lighting-camera-lookdev.mdturntable, scene_mood
Configuración de Cycles/EEVEE, renderizado por lotes, compositorguides/14-rendering-compositing.mdrender_batch
Presupuestos de polígonos, LODs, llamadas de dibujo, proxies de colisiónguides/15-optimization-lod-collision.mdmesh_stats, make_lods
Exportación glTF/FBX/USD para Unity, Unreal, Godot, Roblox, web/Three.jsguides/16-export-engines.mdexport_asset, node/blender-threejs-export.js
QA antes de la entrega (siempre)guides/17-qa-review.mdqa_check, review_shots
Ediciones del Editor de Video, seguimiento de movimiento, resolución de cámaraguides/18-video-editing-tracking.mdvse_edit, track_camera
Videos de producto: mesa giratoria, zoom lento, dolly, grúa, bucle de rampa de velocidad, bucle perfecto, pulido de productoguides/19-product-camera-animations.mdnode/blender-product-polish.js, turntable.py
HDRIs de Poly Haven, texturas, escenas de estudio/showroom, variantes de materialesguides/20-polyhaven-assets.mdnode/polyhaven-*.js
Foto(s) → modelo 3D texturizado (API Meshy, necesita MESHY_API_KEY)guides/21-image-to-3d.mdluego auto_retopo, qa_check
Manuales de principio a fin (prop, personaje, Roblox, toma de producto)guides/22-workflow-recipes.md
Kit de herramientas WebSocket externo opcional (retarget Mixamo mediante complemento Dev-GOM)guides/23-websocket-toolkit.md(no incluido)

Dirección de estilo: abre una sección de estos archivos, no el archivo completo.

Pregunta de estiloAbrir
Estilizado, realista, low-poly, anime/manga, chibi, caricatura, cómic, pintado a mano, píxel, vóxel, isométrico, HD-2D, retro 8/16 bits, noir, toon/NPR, eras de consola (PS1–PS5, CRT/VHS)styles/art-styles.md
Terror, terror PSX, indie, metraje encontrado, corporal, cósmico, folclórico, mascota de terror, liminal, weirdcorestyles/horror.md
Fantasía, ciencia ficción/punk, apocalipsis, histórico, biomas, acogedor, oscuro/áspero, surrealista, brutalista, retrofuturismo neónstyles/worlds-moods.md
Dirección artística por género: acción, cartas/inactivo, metroidvania, VN, mundo abierto, plataformas, carreras, RPG, shooter, soulslike, sigilo, estrategia, supervivenciastyles/game-genres.md

Las referencias de inmersión profunda por tema se encuentran en refs/<original-skill-name>/, y las guías enlazan directamente a ellas.

5. Verificar (obligatorio antes de decir "listo")

  1. Informa números, no adjetivos: tris, objetos, materiales, dimensiones (ob.dimensions) y los archivos de salida escritos.
  2. Si la geometría cambió, ejecuta scripts/qa_check.py (z-fighting, partes desconectadas, no manifold, normales invertidas, escala).
  3. Mira el resultado: MCP get_viewport_screenshot / look, o sin cabeza scripts/review_shots.py hojas de contacto.
  4. Para activos de juego, ejecuta scripts/mesh_stats.py contra el presupuesto de la plataforma y revisa refs/shared/validation-checklist.md.
  5. Confirma que los archivos exportados existen y su tamaño no es cero.

Skills relacionados