Ultimate Blender
Une compétence qui fusionne trois packs : el4cteo (scripts bpy testés + règles Blender 5.x), arjun988 (flux de travail de directeur technique artistique, 90+ guides spécialisés et styles artistiques) et kevinbadi (animations caméra produit, Poly Haven, Meshy photo-3D, export Three.js).
Comment utiliser ce fichier : lisez-le d'abord, puis ouvrez uniquement le(s) guide(s) de la table de routage qui correspondent à la tâche. Ne chargez pas tous les guides. Chaque guide contient des sections issues de chaque pack source pour ce sujet. Tous les chemins sont relatifs au dossier de cette compétence (<skill_root>).
1. Flux directeur (pour chaque nouvel actif)
ANALYZE → PLAN → BRIEF → EXECUTE → VALIDATE → DELIVER
- Analyze : objectif de l'actif (héros / standard / arrière-plan), cible (jeu / cinématique / portfolio / vidéo produit), plateforme (mobile / console / PC / web / Roblox), style, animation (statique / riggée / animée), format d'export.
- Plan : choisissez les guides dans la table de routage (section 4) et définissez les budgets de polygones et de textures (
refs/shared/polycount-budgets.md). - Brief : pour tout ce qui est plus gros qu'une édition rapide, rédigez un court brief de production avant de toucher à Blender : actif, budgets, guides utilisés, phases, cible d'export.
- Execute : exécutez par petites étapes via MCP ou headless (section 2). Utilisez les scripts fournis avant d'écrire du nouveau code.
- Validate : suivez la section 5. Cette étape est obligatoire.
- Deliver : exportez, puis reportez les chiffres et les chemins de fichiers.
Une image de référence est jointe ? Suivez refs/shared/reference-image-match.md : remplissez refs/shared/reference-analysis-template.md, faites correspondre la caméra avant les micro-détails, bouclez sur les comparaisons de captures d'écran, puis vérifiez avec refs/shared/visual-match-checklist.md.
Manuel complet du directeur, avec briefs, recettes multi-compétences et arbres de décision : refs/director-full.md.
Nommage : refs/shared/naming-conventions.md · Pipeline : refs/shared/asset-pipeline.md · MCP : refs/shared/mcp-integration.md, refs/shared/mcp-tools.md.
2. Exécution
En direct (blender-mcp execute_blender_code) : travaillez par petites étapes et n'imprimez que ce dont vous avez besoin. Pour appeler un script fourni :
import sys, importlib; sys.path.insert(0, r"<skill_root>/scripts")
import qa_check; importlib.reload(qa_check); print(qa_check.run(objects=["Chair"]))
Chaque appel MCP s'exécute dans un espace de noms vierge, donc réimportez à chaque fois. Utilisez reload uniquement après avoir modifié un script.
Headless (shell, pas besoin de MCP). Cela n'affiche que le JSON du 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 : utilisez PowerShell de préférence. Dans Git Bash, préfixez avec MSYS_NO_PATHCONV=1 et utilisez $(cygpath -m ~/.claude/skills)/ultimate-blender/.... blender.exe doit être dans le PATH, ou passez son chemin.
Premier appel dans une session : exécutez scripts/env_report.py (version, moteurs, GPU, add-ons, unités, gestion des couleurs).
Helpers Node (kevinbadi ; ils communiquent avec blender-mcp sur le port 9876) : node <skill_root>/scripts/node/<name>.js --help.
3. Règles Blender 5.x (elles remplacent les conseils plus anciens dans tous les guides)
- API Data plutôt que les opérateurs : utilisez
bpy.data,bmesh,mesh.attributes, etforeach_get/setavec numpy. Les opérateurs ont besoin d'un contexte, et le mode arrière-plan n'a pas de vue 3D. - Opérateur inévitable :
with bpy.context.temp_override(object=ob, active_object=ob, selected_objects=[ob], selected_editable_objects=[ob]): bpy.ops..., puis vérifiez{'FINISHED'}. - Mode édition :
ob.dataest obsolète en mode édition. Utilisezbmesh.from_edit_mesh+update_edit_mesh, ou passez d'abord en mode OBJET. - Nœuds : trouvez-les par
type("BSDF_PRINCIPLED"), jamais parname, car les noms sont localisés. - Enums : lisez-les depuis
bl_rna.properties[p].enum_items. Pour les enums dynamiques (render.engine,view_transform), affectez à l'intérieur detry/except TypeError. - Moteurs :
BLENDER_EEVEE,CYCLES,BLENDER_WORKBENCH. GPU :scene.cycles.device="GPU"+ les préférencescompute_device_type. - Maillage évalué :
ob.evaluated_get(dg).to_mesh(), puis toujoursto_mesh_clear(). Appelezview_layer.update()avant de lirematrix_world. - Données libérées : collectez les noms avant de supprimer ou d'appliquer quoi que ce soit, et ne réutilisez jamais l'ancienne référence Python.
- Noms : ne faites jamais confiance à "Cube.001". Renommez explicitement et cherchez les objets avec
bpy.data.objects[name]. - Échelle : 1 unité = 1 m. Appliquez la rotation et l'échelle avant les biseaux, le rigging, la physique, le baking et l'export.
- Les sessions en direct sont le travail de l'utilisateur : n'utilisez jamais
read_factory_settings, ne supprimez jamais de données que vous n'avez pas créées, et sauvegardez une copie (save_as_mainfile(copy=True)) avant les modifications par lots destructrices. - GPU en arrière-plan : appelez
gpu.init()(5.2+).bgln'existe plus. Le mode Sculpture plante dans-b, donc utilisezscripts/sculpt_ops.py. - Ruptures API 5.x :
action.fcurves→ channelbags ·scene.node_tree→scene.compositing_node_group·material.use_nodesdéprécié ·mod["Socket_2"]→mod.properties.inputs.Socket_2.value·BLENDER_EEVEE_NEXT→BLENDER_EEVEE· BooléenFAST→FLOAT· couches d'os → collections d'os ·bl_info→blender_manifest.toml· 5.3 : pile d'effets du compositeur,EXPANDde la VSE →RIPPLE. Tableau complet :refs/blender-core/api-changes-5x.md. Modèles de code :refs/blender-core/bpy-patterns.md.
4. Routage : tâche → guide (+ scripts)
| Tâche | Ouvrir | Scripts clés |
|---|---|---|
| Unités, nommage, collections, bibliothèques d'actifs, pipelines par lots/headless, add-ons/extensions | guides/01-scene-pipeline.md | scene_audit, batch_process, assets/addon_template |
| Surface dure, biseaux, booléens, normales pondérées, modélisation générale, modélisation procédurale | guides/02-modeling-hardsurface.md | apply_stack |
| Accessoires, kitbash, meubles, véhicules, mechas, archviz | guides/03-props-vehicles-archviz.md | apply_stack, build_pbr_material |
| Sculpture, multires, remesh, créatures, monstres | guides/04-sculpting-creatures.md | sculpt_ops |
| Personnages humains, archétypes, vêtements, rig facial, ARKit / visèmes | guides/05-characters-clothing-face.md | garment, shapekeys |
| Cheveux, fourrure, hair cards | guides/06-hair-groom.md | groom |
| Retopologie, dépliage UV, densité texel, UDIM, lightmap UV | guides/07-retopology-uv.md | auto_retopo, uv_pack, texel_density |
| Matériaux PBR, usure et saleté, décalcomanies, feuilles de garniture, baking | guides/08-materials-texturing-baking.md | build_pbr_material, smart_material, decal, bake_maps |
| Geometry Nodes, générateurs procéduraux, dispersion | guides/09-geometry-nodes.md | gn_builder |
| Terrain, biomes, kits modulaires, végétation, habillage de scène | guides/10-environments-vegetation.md | terrain, scatter, kit_check |
| Rigify, skinning, squelettes de jeu, keyframes, NLA, retarget mocap, boucles | guides/11-rigging-animation.md | rigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check |
| Corps rigide, tissu, fluides, destruction, VFX, pluie, neige, éclairs | guides/12-simulation-vfx-weather.md | sim_setup, precipitation, surface_weather, lightning |
| Rigs d'éclairage, HDRI, look-dev, caméra, heure de la journée, brouillard, ambiances | guides/13-lighting-camera-lookdev.md | turntable, scene_mood |
| Paramètres Cycles/EEVEE, rendu par lots, compositeur | guides/14-rendering-compositing.md | render_batch |
| Budgets de polygones, LODs, appels de tirage, proxies de collision | guides/15-optimization-lod-collision.md | mesh_stats, make_lods |
| Export glTF/FBX/USD pour Unity, Unreal, Godot, Roblox, web/Three.js | guides/16-export-engines.md | export_asset, node/blender-threejs-export.js |
| QA avant livraison (toujours) | guides/17-qa-review.md | qa_check, review_shots |
| Montage Video Sequencer, suivi de mouvement, résolution de caméra | guides/18-video-editing-tracking.md | vse_edit, track_camera |
| Vidéos produit : plateau tournant, zoom lent, dolly, grue, boucle speed-ramp, boucle parfaite, polissage produit | guides/19-product-camera-animations.md | node/blender-product-polish.js, turntable.py |
| HDRIs Poly Haven, textures, scènes studio/showroom, variantes de matériaux | guides/20-polyhaven-assets.md | node/polyhaven-*.js |
Photo(s) → modèle 3D texturé (API Meshy, nécessite MESHY_API_KEY) | guides/21-image-to-3d.md | puis auto_retopo, qa_check |
| Manuels de bout en bout (accessoire, personnage, Roblox, prise de vue produit) | guides/22-workflow-recipes.md | |
| Boîte à outils WebSocket externe optionnelle (retarget Mixamo via add-on Dev-GOM) | guides/23-websocket-toolkit.md | (non fourni) |
Direction stylistique : ouvrez une section de ces fichiers, pas le fichier entier.
| Demande de style | Ouvrir |
|---|---|
| Stylisé, réaliste, low-poly, anime/manga, chibi, cartoon, comic, peint à la main, pixel, voxel, isométrique, HD-2D, rétro 8/16-bit, noir, toon/NPR, époques de consoles (PS1–PS5, CRT/VHS) | styles/art-styles.md |
| Horreur, horreur PSX, indie, found-footage, body, cosmique, folk, mascotte horrifique, liminal, weirdcore | styles/horror.md |
| Fantastique, sci-fi/punk, apocalypse, historique, biomes, cozy, sombre/gritty, surréaliste, brutaliste, rétrofuturisme néon | styles/worlds-moods.md |
| Direction artistique par genre : action, cartes/idle, metroidvania, VN, monde ouvert, plateformer, course, RPG, tireur, soulslike, infiltration, stratégie, survie | styles/game-genres.md |
Les références approfondies par sujet se trouvent dans refs/<original-skill-name>/, et les guides y renvoient directement.
5. Vérifier (obligatoire avant de dire "terminé")
- Reportez des chiffres, pas des adjectifs : tris, objets, matériaux, dimensions (
ob.dimensions) et les fichiers de sortie écrits. - Si la géométrie a changé, exécutez
scripts/qa_check.py(z-fighting, parties détachées, non-manifold, normales inversées, échelle). - Regardez le résultat : MCP
get_viewport_screenshot/look, ou headlessscripts/review_shots.pyplanches contact. - Pour les actifs de jeu, exécutez
scripts/mesh_stats.pypar rapport au budget de la plateforme, et parcourezrefs/shared/validation-checklist.md. - Confirmez que les fichiers exportés existent et que leur taille est non nulle.