Communitygithub.com

ultimate-blender

Compétence tout-en-un pour Blender 5.x : modélisation, sculpture, retopo/UV, PBR, baking, rigging, animation, simulations, VFX, éclairage, rendu, export jeu, plateaux tournants produits, Poly Haven, photo-3D, 90+ styles artistiques. Pilote Blender via blender-mcp ou en mode headless en ligne de commande.

Qu'est-ce que ultimate-blender ?

Cette compétence fusionne trois packs spécialisés – 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) – en un seul outil polyvalent pour Blender. Elle suit un flux directeur structuré ANALYZE → PLAN → BRIEF → EXECUTE → VALIDATE → DELIVER qui garantit que chaque nouvel actif est abordé de manière professionnelle : l'IA analyse d'abord l'usage et les contraintes (plateforme, style, format d'export), planifie les polycopiés et textures budgets, rédige un brief si nécessaire, exécute par petites étapes via MCP ou headless, valide avec des scripts de QA, puis livre avec des rapports chiffrés. La compétence propose 23 guides thématiques couvrant tous les domaines de la production 3D (scène, modélisation, personnages, cheveux, UV, matériaux PBR, nodes de géométrie, environnements, rigging, animation, simulations, éclairage, rendu, optimisation, export, QA, montage vidéo, animations produit, assets Poly Haven, photo-3D, etc.) et 3 fichiers de référence pour les styles artistiques (art styles, horreur, univers/moods, genres de jeux). Chaque guide est directement lié à des scripts prêts à l'emploi dans le dossier `<skill_root>/scripts/`. Elle prend en charge à la fois les sessions live via blender-mcp (appels de code Blender pas à pas) et l'exécution headless en ligne de commande (sans interface graphique), avec des helpers Node.js optionnels pour certaines tâches. Les règles Blender 5.x sont intégrées en priorité, avec des recommandations sur l'utilisation de l'API Data, les opérateurs, les modes édition, les nœuds, les enums, les moteurs de rendu, l'évalué mesh, l'échelle et la sauvegarde.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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
  1. 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.
  2. 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).
  3. 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.
  4. Execute : exécutez par petites étapes via MCP ou headless (section 2). Utilisez les scripts fournis avant d'écrire du nouveau code.
  5. Validate : suivez la section 5. Cette étape est obligatoire.
  6. 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, et foreach_get/set avec 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.data est obsolète en mode édition. Utilisez bmesh.from_edit_mesh + update_edit_mesh, ou passez d'abord en mode OBJET.
  • Nœuds : trouvez-les par type ("BSDF_PRINCIPLED"), jamais par name, 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 de try/except TypeError.
  • Moteurs : BLENDER_EEVEE, CYCLES, BLENDER_WORKBENCH. GPU : scene.cycles.device="GPU" + les préférences compute_device_type.
  • Maillage évalué : ob.evaluated_get(dg).to_mesh(), puis toujours to_mesh_clear(). Appelez view_layer.update() avant de lire matrix_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+). bgl n'existe plus. Le mode Sculpture plante dans -b, donc utilisez scripts/sculpt_ops.py.
  • Ruptures API 5.x : action.fcurves → channelbags · scene.node_tree → scene.compositing_node_group · material.use_nodes déprécié · mod["Socket_2"] → mod.properties.inputs.Socket_2.value · BLENDER_EEVEE_NEXT → BLENDER_EEVEE · Booléen FAST → FLOAT · couches d'os → collections d'os · bl_info → blender_manifest.toml · 5.3 : pile d'effets du compositeur, EXPAND de 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âcheOuvrirScripts clés
Unités, nommage, collections, bibliothèques d'actifs, pipelines par lots/headless, add-ons/extensionsguides/01-scene-pipeline.mdscene_audit, batch_process, assets/addon_template
Surface dure, biseaux, booléens, normales pondérées, modélisation générale, modélisation procéduraleguides/02-modeling-hardsurface.mdapply_stack
Accessoires, kitbash, meubles, véhicules, mechas, archvizguides/03-props-vehicles-archviz.mdapply_stack, build_pbr_material
Sculpture, multires, remesh, créatures, monstresguides/04-sculpting-creatures.mdsculpt_ops
Personnages humains, archétypes, vêtements, rig facial, ARKit / visèmesguides/05-characters-clothing-face.mdgarment, shapekeys
Cheveux, fourrure, hair cardsguides/06-hair-groom.mdgroom
Retopologie, dépliage UV, densité texel, UDIM, lightmap UVguides/07-retopology-uv.mdauto_retopo, uv_pack, texel_density
Matériaux PBR, usure et saleté, décalcomanies, feuilles de garniture, bakingguides/08-materials-texturing-baking.mdbuild_pbr_material, smart_material, decal, bake_maps
Geometry Nodes, générateurs procéduraux, dispersionguides/09-geometry-nodes.mdgn_builder
Terrain, biomes, kits modulaires, végétation, habillage de scèneguides/10-environments-vegetation.mdterrain, scatter, kit_check
Rigify, skinning, squelettes de jeu, keyframes, NLA, retarget mocap, bouclesguides/11-rigging-animation.mdrigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check
Corps rigide, tissu, fluides, destruction, VFX, pluie, neige, éclairsguides/12-simulation-vfx-weather.mdsim_setup, precipitation, surface_weather, lightning
Rigs d'éclairage, HDRI, look-dev, caméra, heure de la journée, brouillard, ambiancesguides/13-lighting-camera-lookdev.mdturntable, scene_mood
Paramètres Cycles/EEVEE, rendu par lots, compositeurguides/14-rendering-compositing.mdrender_batch
Budgets de polygones, LODs, appels de tirage, proxies de collisionguides/15-optimization-lod-collision.mdmesh_stats, make_lods
Export glTF/FBX/USD pour Unity, Unreal, Godot, Roblox, web/Three.jsguides/16-export-engines.mdexport_asset, node/blender-threejs-export.js
QA avant livraison (toujours)guides/17-qa-review.mdqa_check, review_shots
Montage Video Sequencer, suivi de mouvement, résolution de caméraguides/18-video-editing-tracking.mdvse_edit, track_camera
Vidéos produit : plateau tournant, zoom lent, dolly, grue, boucle speed-ramp, boucle parfaite, polissage produitguides/19-product-camera-animations.mdnode/blender-product-polish.js, turntable.py
HDRIs Poly Haven, textures, scènes studio/showroom, variantes de matériauxguides/20-polyhaven-assets.mdnode/polyhaven-*.js
Photo(s) → modèle 3D texturé (API Meshy, nécessite MESHY_API_KEY)guides/21-image-to-3d.mdpuis 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 styleOuvrir
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, weirdcorestyles/horror.md
Fantastique, sci-fi/punk, apocalypse, historique, biomes, cozy, sombre/gritty, surréaliste, brutaliste, rétrofuturisme néonstyles/worlds-moods.md
Direction artistique par genre : action, cartes/idle, metroidvania, VN, monde ouvert, plateformer, course, RPG, tireur, soulslike, infiltration, stratégie, surviestyles/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é")

  1. Reportez des chiffres, pas des adjectifs : tris, objets, matériaux, dimensions (ob.dimensions) et les fichiers de sortie écrits.
  2. 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).
  3. Regardez le résultat : MCP get_viewport_screenshot / look, ou headless scripts/review_shots.py planches contact.
  4. Pour les actifs de jeu, exécutez scripts/mesh_stats.py par rapport au budget de la plateforme, et parcourez refs/shared/validation-checklist.md.
  5. Confirmez que les fichiers exportés existent et que leur taille est non nulle.

Skills associés