Ultimate Blender
Um skill que funde três pacotes: el4cteo (scripts bpy testados + regras do Blender 5.x), arjun988 (fluxo de trabalho de Diretor Técnico de Arte, mais de 90 guias especializados e de estilo) e kevinbadi (animações de câmera de produto, Poly Haven, Meshy foto-para-3D, exportação Three.js).
Como usar este arquivo: leia-o primeiro, depois abra apenas o(s) guia(s) na tabela de roteamento que correspondem à tarefa. Não carregue todos os guias. Cada guia possui seções de cada pacote fonte para aquele tópico. Todos os caminhos são relativos à pasta deste skill (<skill_root>).
1. Fluxo de trabalho do diretor (a cada novo ativo)
ANALISAR → PLANEJAR → RESUMIR → EXECUTAR → VALIDAR → ENTREGAR
- Analisar: propósito do ativo (herói / padrão / fundo), destino (jogo / cinematográfico / portfólio / vídeo de produto), plataforma (mobile / console / PC / web / Roblox), estilo, animação (estático / rigado / animado), formato de exportação.
- Planejar: escolha guias da tabela de roteamento (seção 4) e defina os orçamentos de polígonos e texturas (
refs/shared/polycount-budgets.md). - Resumir: para qualquer coisa maior que uma edição rápida, escreva um breve resumo de produção antes de tocar no Blender: ativo, orçamentos, guias usados, fases, destino de exportação.
- Executar: execute pequenos passos via MCP ou headless (seção 2). Use os scripts incluídos antes de escrever código novo.
- Validar: siga a seção 5. Esta etapa é obrigatória.
- Entregar: exporte, depois relate números e caminhos de arquivos.
Imagem de referência anexada? Siga refs/shared/reference-image-match.md: preencha refs/shared/reference-analysis-template.md, ajuste a câmera antes dos microdetalhes, itere com comparações de captura de tela, depois verifique com refs/shared/visual-match-checklist.md.
Manual completo do diretor, com resumos, receitas multi-skill e árvores de decisão: 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. Executar
Ao vivo (blender-mcp execute_blender_code): trabalhe em pequenos passos e imprima apenas o necessário. Para chamar um script incluído:
import sys, importlib; sys.path.insert(0, r"<skill_root>/scripts")
import qa_check; importlib.reload(qa_check); print(qa_check.run(objects=["Cadeira"]))
Cada chamada MCP executa em um namespace novo, então reimporte a cada vez. Use reload apenas após editar um script.
Headless (shell, sem MCP necessário). Isso imprime apenas o JSON do script:
python <skill_root>/scripts/run_in_blender.py --blend in.blend <skill_root>/scripts/<script.py> -- --objects Cadeira --save out.blend
python <skill_root>/scripts/run_in_blender.py --expr "import bpy; print(len(bpy.data.objects))"
Windows: prefira PowerShell. No Git Bash, prefixe com MSYS_NO_PATHCONV=1 e use $(cygpath -m ~/.claude/skills)/ultimate-blender/.... blender.exe deve estar no PATH, ou informe seu caminho.
Primeira chamada em uma sessão: execute scripts/env_report.py (versão, mecanismos, GPU, add-ons, unidades, gerenciamento de cor).
Auxiliares Node (kevinbadi; eles se comunicam com blender-mcp na porta 9876): node <skill_root>/scripts/node/<nome>.js --help.
3. Regras do Blender 5.x (estas substituem conselhos mais antigos em qualquer guia)
- API de Dados sobre operadores: use
bpy.data,bmesh,mesh.attributeseforeach_get/setcom numpy. Operadores precisam de contexto e o modo background não tem janela 3D. - Operador inevitável:
with bpy.context.temp_override(object=ob, active_object=ob, selected_objects=[ob], selected_editable_objects=[ob]): bpy.ops..., depois verifique{'FINISHED'}. - Modo Edição:
ob.datafica desatualizado enquanto no Modo Edição. Usebmesh.from_edit_mesh+update_edit_mesh, ou mude para o modo OBJETO primeiro. - Nós: encontre-os pelo
type("BSDF_PRINCIPLED"), nunca peloname, pois os nomes são localizados. - Enums: leia-os de
bl_rna.properties[p].enum_items. Para enums dinâmicos (render.engine,view_transform), atribua dentro detry/except TypeError. - Mecanismos:
BLENDER_EEVEE,CYCLES,BLENDER_WORKBENCH. GPU:scene.cycles.device="GPU"+ as preferênciascompute_device_type. - Malha avaliada:
ob.evaluated_get(dg).to_mesh(), depois sempreto_mesh_clear(). Chameview_layer.update()antes de lermatrix_world. - Dados liberados: colete nomes antes de remover ou aplicar qualquer coisa, e nunca reutilize a referência Python antiga.
- Nomes: nunca confie em "Cube.001". Renomeie explicitamente e procure objetos com
bpy.data.objects[nome]. - Escala: 1 unidade = 1 m. Aplique rotação e escala antes de chanfros, rigging, física, baking e exportação.
- Sessões ao vivo são o trabalho do usuário: nunca
read_factory_settings, nunca delete dados que você não criou, e salve um backup (save_as_mainfile(copy=True)) antes de edições destrutivas em lote. - GPU em segundo plano: chame
gpu.init()(5.2+).bglnão existe mais. O Modo Escultura trava em-b, então usescripts/sculpt_ops.py. - Quebras de API 5.x:
action.fcurves→ channelbags ·scene.node_tree→scene.compositing_node_group·material.use_nodesobsoleto ·mod["Socket_2"]→mod.properties.inputs.Socket_2.value·BLENDER_EEVEE_NEXT→BLENDER_EEVEE· BooleanoFAST→FLOAT· camadas de osso → coleções de osso ·bl_info→blender_manifest.toml· 5.3: pilha de efeitos do compositor, VSEEXPAND→RIPPLE. Tabela completa:refs/blender-core/api-changes-5x.md. Padrões de código:refs/blender-core/bpy-patterns.md.
4. Roteamento: tarefa → guia (+ scripts)
| Tarefa | Abrir | Scripts principais |
|---|---|---|
| Unidades, nomenclatura, coleções, bibliotecas de ativos, pipelines headless/em lote, add-ons/extensões | guides/01-scene-pipeline.md | scene_audit, batch_process, assets/addon_template |
| Superfície dura, chanfros, booleanos, normais ponderadas, modelagem geral, modelagem procedural | guides/02-modeling-hardsurface.md | apply_stack |
| Props, kitbash, mobiliário, veículos, mechs, archviz | guides/03-props-vehicles-archviz.md | apply_stack, build_pbr_material |
| Escultura, multires, remesh, criaturas, monstros | guides/04-sculpting-creatures.md | sculpt_ops |
| Personagens humanos, arquétipos, roupas, rig facial, ARKit / visemas | guides/05-characters-clothing-face.md | garment, shapekeys |
| Cabelo, pelo, hair cards | guides/06-hair-groom.md | groom |
| Retopologia, UV unwrap, densidade de texel, UDIM, lightmap UV | guides/07-retopology-uv.md | auto_retopo, uv_pack, texel_density |
| Materiais PBR, desgaste e sujeira, decalques, trim sheets, baking | guides/08-materials-texturing-baking.md | build_pbr_material, smart_material, decal, bake_maps |
| Geometry Nodes, geradores procedurais, scattering | guides/09-geometry-nodes.md | gn_builder |
| Terreno, biomas, kits modulares, vegetação, set dressing | guides/10-environments-vegetation.md | terrain, scatter, kit_check |
| Rigify, skinning, esqueletos de jogos, keyframes, NLA, retarget de mocap, loops | guides/11-rigging-animation.md | rigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check |
| Corpo rígido, tecido, fluidos, destruição, VFX, chuva, neve, relâmpago | guides/12-simulation-vfx-weather.md | sim_setup, precipitation, surface_weather, lightning |
| Rigs de iluminação, HDRI, look-dev, câmera, hora do dia, nevoeiro, humores | guides/13-lighting-camera-lookdev.md | turntable, scene_mood |
| Configurações de Cycles/EEVEE, renderização em lote, compositor | guides/14-rendering-compositing.md | render_batch |
| Orçamentos de polígonos, LODs, chamadas de draw, proxies de colisão | guides/15-optimization-lod-collision.md | mesh_stats, make_lods |
| Exportar glTF/FBX/USD para Unity, Unreal, Godot, Roblox, web/Three.js | guides/16-export-engines.md | export_asset, node/blender-threejs-export.js |
| QA antes da entrega (sempre) | guides/17-qa-review.md | qa_check, review_shots |
| Edições no Video Sequencer, motion tracking, camera solve | guides/18-video-editing-tracking.md | vse_edit, track_camera |
| Vídeos de produto: turntable, zoom lento, dolly, grua, speed-ramp loop, loop perfeito, polimento de produto | guides/19-product-camera-animations.md | node/blender-product-polish.js, turntable.py |
| HDRIs do Poly Haven, texturas, cenas de estúdio/showroom, variantes de material | guides/20-polyhaven-assets.md | node/polyhaven-*.js |
Foto(s) → modelo 3D texturizado (API Meshy, precisa de MESHY_API_KEY) | guides/21-image-to-3d.md | depois auto_retopo, qa_check |
| Manuais ponta a ponta (prop, personagem, Roblox, foto de produto) | guides/22-workflow-recipes.md | |
| Toolkit WebSocket externo opcional (retarget Mixamo via add-on Dev-GOM) | guides/23-websocket-toolkit.md | (não incluído) |
Direção de estilo: abra uma seção destes arquivos, não o arquivo inteiro.
| Pedido de estilo | Abrir |
|---|---|
| Estilizado, realista, low-poly, anime/manga, chibi, cartoon, quadrinhos, pintado à mão, pixel, voxel, isométrico, HD-2D, retrô 8/16-bit, noir, toon/NPR, eras de console (PS1–PS5, CRT/VHS) | styles/art-styles.md |
| Terror, terror PSX, indie, found-footage, corporal, cósmico, folk, terror mascote, liminal, weirdcore | styles/horror.md |
| Fantasia, sci-fi/punk, apocalipse, histórico, biomas, aconchegante, escuro/sombrio, surreal, brutalista, retrofuturismo neon | styles/worlds-moods.md |
| Direção de arte por gênero: ação, card/idle, metroidvania, VN, mundo aberto, plataforma, corrida, RPG, tiro, soulslike, furtividade, estratégia, sobrevivência | styles/game-genres.md |
Referências aprofundadas por tópico estão em refs/<nome-do-skill-original>/, e os guias linkam diretamente para elas.
5. Verificar (obrigatório antes de dizer "pronto")
- Relate números, não adjetivos: tris, objetos, materiais, dimensões (
ob.dimensions) e os arquivos de saída gravados. - Se a geometria mudou, execute
scripts/qa_check.py(z-fighting, partes soltas, não-manifold, normais invertidas, escala). - Veja o resultado: MCP
get_viewport_screenshot/look, ou headless contact sheets descripts/review_shots.py. - Para ativos de jogo, execute
scripts/mesh_stats.pycontra o orçamento da plataforma e reviserefs/shared/validation-checklist.md. - Confirme que os arquivos exportados existem e seu tamanho é diferente de zero.