Communitygithub.com

ultimate-blender

Skill tudo-em-um para Blender 5.x, cobrindo qualquer tarefa com Blender, bpy, .blend ou ativos 3D. Inclui modelagem, escultura, retopo/UV, PBR, baking, rigging, animação, simulações, VFX, iluminação, renderização, exportação para jogos, turntables de produto, Poly Haven, foto-para-3D e mais de 90 estilos artísticos. Controla o Blender via blender-mcp ou CLI headless.

O que é ultimate-blender?

O Ultimate Blender é um skill unificado para agentes de IA que trabalham com Blender 5.x. Ele combina três pacotes de especialização: scripts bpy testados e regras do Blender 5.x (el4cteo), um fluxo de trabalho de Diretor Técnico de Arte com mais de 90 guias de especialistas e estilos (arjun988), e funcionalidades de animação de câmera de produto, Poly Haven, Meshy foto-para-3D e exportação Three.js (kevinbadi). O skill segue um fluxo de trabalho de diretor de 6 etapas: Analisar, Planejar, Resumir, Executar, Validar e Entregar. Ele opera tanto ao vivo via blender-mCP (executando código em pequenos passos) quanto em modo headless via shell, com scripts Python e Node.js incluídos. O skill impõe as melhores práticas da API do Blender 5.x, como usar a API de Dados sobre operadores, lidar com freed data e aplicar escala antes de operações destrutivas. Um roteador de tarefas abrangente (seção 4) mapeia mais de 20 guias para tarefas específicas, desde pipeline de cena até exportação para mecanismos de jogo, incluindo verificação de qualidade obrigatória antes da entrega. O skill também oferece direção de estilo para arte, horror, mundos/humor e gêneros de jogos em arquivos dedicados.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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
  1. 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.
  2. 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).
  3. 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.
  4. Executar: execute pequenos passos via MCP ou headless (seção 2). Use os scripts incluídos antes de escrever código novo.
  5. Validar: siga a seção 5. Esta etapa é obrigatória.
  6. 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.attributes e foreach_get/set com 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.data fica desatualizado enquanto no Modo Edição. Use bmesh.from_edit_mesh + update_edit_mesh, ou mude para o modo OBJETO primeiro.
  • Nós: encontre-os pelo type ("BSDF_PRINCIPLED"), nunca pelo name, 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 de try/except TypeError.
  • Mecanismos: BLENDER_EEVEE, CYCLES, BLENDER_WORKBENCH. GPU: scene.cycles.device="GPU" + as preferências compute_device_type.
  • Malha avaliada: ob.evaluated_get(dg).to_mesh(), depois sempre to_mesh_clear(). Chame view_layer.update() antes de ler matrix_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+). bgl não existe mais. O Modo Escultura trava em -b, então use scripts/sculpt_ops.py.
  • Quebras 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 · camadas de osso → coleções de osso · bl_info → blender_manifest.toml · 5.3: pilha de efeitos do compositor, VSE EXPAND → 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)

TarefaAbrirScripts principais
Unidades, nomenclatura, coleções, bibliotecas de ativos, pipelines headless/em lote, add-ons/extensõesguides/01-scene-pipeline.mdscene_audit, batch_process, assets/addon_template
Superfície dura, chanfros, booleanos, normais ponderadas, modelagem geral, modelagem proceduralguides/02-modeling-hardsurface.mdapply_stack
Props, kitbash, mobiliário, veículos, mechs, archvizguides/03-props-vehicles-archviz.mdapply_stack, build_pbr_material
Escultura, multires, remesh, criaturas, monstrosguides/04-sculpting-creatures.mdsculpt_ops
Personagens humanos, arquétipos, roupas, rig facial, ARKit / visemasguides/05-characters-clothing-face.mdgarment, shapekeys
Cabelo, pelo, hair cardsguides/06-hair-groom.mdgroom
Retopologia, UV unwrap, densidade de texel, UDIM, lightmap UVguides/07-retopology-uv.mdauto_retopo, uv_pack, texel_density
Materiais PBR, desgaste e sujeira, decalques, trim sheets, bakingguides/08-materials-texturing-baking.mdbuild_pbr_material, smart_material, decal, bake_maps
Geometry Nodes, geradores procedurais, scatteringguides/09-geometry-nodes.mdgn_builder
Terreno, biomas, kits modulares, vegetação, set dressingguides/10-environments-vegetation.mdterrain, scatter, kit_check
Rigify, skinning, esqueletos de jogos, keyframes, NLA, retarget de mocap, loopsguides/11-rigging-animation.mdrigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check
Corpo rígido, tecido, fluidos, destruição, VFX, chuva, neve, relâmpagoguides/12-simulation-vfx-weather.mdsim_setup, precipitation, surface_weather, lightning
Rigs de iluminação, HDRI, look-dev, câmera, hora do dia, nevoeiro, humoresguides/13-lighting-camera-lookdev.mdturntable, scene_mood
Configurações de Cycles/EEVEE, renderização em lote, compositorguides/14-rendering-compositing.mdrender_batch
Orçamentos de polígonos, LODs, chamadas de draw, proxies de colisãoguides/15-optimization-lod-collision.mdmesh_stats, make_lods
Exportar glTF/FBX/USD para Unity, Unreal, Godot, Roblox, web/Three.jsguides/16-export-engines.mdexport_asset, node/blender-threejs-export.js
QA antes da entrega (sempre)guides/17-qa-review.mdqa_check, review_shots
Edições no Video Sequencer, motion tracking, camera solveguides/18-video-editing-tracking.mdvse_edit, track_camera
Vídeos de produto: turntable, zoom lento, dolly, grua, speed-ramp loop, loop perfeito, polimento de produtoguides/19-product-camera-animations.mdnode/blender-product-polish.js, turntable.py
HDRIs do Poly Haven, texturas, cenas de estúdio/showroom, variantes de materialguides/20-polyhaven-assets.mdnode/polyhaven-*.js
Foto(s) → modelo 3D texturizado (API Meshy, precisa de MESHY_API_KEY)guides/21-image-to-3d.mddepois 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 estiloAbrir
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, weirdcorestyles/horror.md
Fantasia, sci-fi/punk, apocalipse, histórico, biomas, aconchegante, escuro/sombrio, surreal, brutalista, retrofuturismo neonstyles/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ênciastyles/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")

  1. Relate números, não adjetivos: tris, objetos, materiais, dimensões (ob.dimensions) e os arquivos de saída gravados.
  2. Se a geometria mudou, execute scripts/qa_check.py (z-fighting, partes soltas, não-manifold, normais invertidas, escala).
  3. Veja o resultado: MCP get_viewport_screenshot / look, ou headless contact sheets de scripts/review_shots.py.
  4. Para ativos de jogo, execute scripts/mesh_stats.py contra o orçamento da plataforma e revise refs/shared/validation-checklist.md.
  5. Confirme que os arquivos exportados existem e seu tamanho é diferente de zero.

Habilidades Relacionadas