Was macht Ultimate Blender?
Ein Skill, der drei Packs vereint: el4cteo (getestete bpy-Skripte + Blender 5.x-Regeln), arjun988 (Technical Art Director-Workflow, über 90 Spezialisten- und Stilrichtungen) und kevinbadi (Produktkamera-Animationen, Poly Haven, Meshy-Foto-zu-3D, Three.js-Export).
So verwenden Sie diese Datei: Lesen Sie sie zuerst, öffnen Sie dann nur die Guides aus der Routingtabelle, die zur Aufgabe passen. Laden Sie nicht jeden Guide. Jeder Guide enthält Abschnitte aus jedem Quellpaket zum jeweiligen Thema. Alle Pfade sind relativ zum Ordner dieses Skills (<skill_root>).
1. Director-Workflow (bei jedem neuen Asset)
ANALYZE → PLAN → BRIEF → EXECUTE → VALIDATE → DELIVER
- Analysieren: Asset-Zweck (Hero / Standard / Hintergrund), Ziel (Game / Kinofilm / Portfolio / Produktvideo), Plattform (Mobile / Konsole / PC / Web / Roblox), Stil, Animation (statisch / geriggt / animiert), Exportformat.
- Planen: Guides aus der Routingtabelle (Abschnitt 4) auswählen und die Polygon- und Texturbudgets festlegen (
refs/shared/polycount-budgets.md). - Briefing: Für alles, was größer als eine schnelle Bearbeitung ist, vor dem Öffnen von Blender ein kurzes Produktions-Briefing schreiben: Asset, Budgets, verwendete Guides, Phasen, Exportziel.
- Ausführen: Kleine Schritte über MCP oder headless ausführen (Abschnitt 2). Die gebündelten Skripte verwenden, bevor neuer Code geschrieben wird.
- Validieren: Abschnitt 5 befolgen. Dieser Schritt ist erforderlich.
- Ausliefern: Exportieren, dann Zahlen und Dateipfade melden.
Referenzbild angehängt? Befolgen Sie refs/shared/reference-image-match.md: refs/shared/reference-analysis-template.md ausfüllen, die Kamera vor Mikrodetails angleichen, mit Screenshot-Vergleichen iterieren, dann gegen refs/shared/visual-match-checklist.md prüfen.
Vollständiges Director-Playbook mit Briefings, Multi-Skill-Rezepten und Entscheidungsbäumen: refs/director-full.md.
Benennung: refs/shared/naming-conventions.md · Pipeline: refs/shared/asset-pipeline.md · MCP: refs/shared/mcp-integration.md, refs/shared/mcp-tools.md.
2. Ausführen
Live (blender-mcp execute_blender_code): Arbeiten Sie in kleinen Schritten und geben Sie nur das Nötigste aus. So rufen Sie ein gebündeltes Skript auf:
import sys, importlib; sys.path.insert(0, r"<skill_root>/scripts")
import qa_check; importlib.reload(qa_check); print(qa_check.run(objects=["Chair"]))
Jeder MCP-Aufruf läuft in einem neuen Namensraum, also jedes Mal erneut importieren. Verwenden Sie reload nur nach dem Bearbeiten eines Skripts.
Headless (Shell, kein MCP nötig). Dies gibt nur das JSON des Skripts aus:
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: PowerShell bevorzugen. In Git Bash mit MSYS_NO_PATHCONV=1 voranstellen und $(cygpath -m ~/.claude/skills)/ultimate-blender/... verwenden. blender.exe muss im PATH sein oder der Pfad muss übergeben werden.
Erster Aufruf in einer Sitzung: scripts/env_report.py ausführen (Version, Engines, GPU, Add-ons, Einheiten, Farbmanagement).
Node-Helfer (kevinbadi; sie kommunizieren mit blender-mcp auf Port 9876): node <skill_root>/scripts/node/<name>.js --help.
3. Blender 5.x-Regeln (diese überschreiben ältere Ratschläge in jedem Guide)
- Data API vor Operatoren:
bpy.data,bmesh,mesh.attributesundforeach_get/setmit NumPy verwenden. Operatoren benötigen einen Kontext, und der Hintergrundmodus hat keine 3D-Ansicht. - Unvermeidbarer Operator:
with bpy.context.temp_override(object=ob, active_object=ob, selected_objects=[ob], selected_editable_objects=[ob]): bpy.ops..., dann auf{'FINISHED'}prüfen. - Edit-Modus:
ob.dataist im Edit-Modus veraltet.bmesh.from_edit_mesh+update_edit_meshverwenden oder zuerst in den OBJECT-Modus wechseln. - Nodes: Nach
typesuchen ("BSDF_PRINCIPLED"), niemals nachname, da Namen lokalisiert sind. - Enums: Aus
bl_rna.properties[p].enum_itemslesen. Für dynamische Enums (render.engine,view_transform) innerhalb vontry/except TypeErrorzuweisen. - Engines:
BLENDER_EEVEE,CYCLES,BLENDER_WORKBENCH. GPU:scene.cycles.device="GPU"+ die Voreinstellungencompute_device_type. - Evaluated Mesh:
ob.evaluated_get(dg).to_mesh(), dann immerto_mesh_clear().view_layer.update()vor dem Lesen vonmatrix_worldaufrufen. - Freigegebene Daten: Namen vor dem Entfernen oder Anwenden sammeln und niemals die alte Python-Referenz wiederverwenden.
- Namen: Nie "Cube.001" vertrauen. Explizit umbenennen und Objekte mit
bpy.data.objects[name]nachschlagen. - Maßstab: 1 Einheit = 1 m. Rotation und Maßstab vor Fasen, Rigging, Physik, Baking und Export anwenden.
- Live-Sitzungen sind die Arbeit des Benutzers: Niemals
read_factory_settingsaufrufen, niemals Daten löschen, die Sie nicht erstellt haben, und vor destruktiven Batch-Bearbeitungen ein Backup speichern (save_as_mainfile(copy=True)). - Hintergrund-GPU:
gpu.init()aufrufen (5.2+).bglexistiert nicht mehr. Der Sculpt-Modus stürzt in-bab, daherscripts/sculpt_ops.pyverwenden. - 5.x-API-Brüche:
action.fcurves→ Channelbags ·scene.node_tree→scene.compositing_node_group·material.use_nodesveraltet ·mod["Socket_2"]→mod.properties.inputs.Socket_2.value·BLENDER_EEVEE_NEXT→BLENDER_EEVEE· BooleanFAST→FLOAT· Bone-Layer → Bone-Collections ·bl_info→blender_manifest.toml· 5.3: Compositor-Effekte-Stapel, VSEEXPAND→RIPPLE. Vollständige Tabelle:refs/blender-core/api-changes-5x.md. Code-Muster:refs/blender-core/bpy-patterns.md.
4. Routing: Aufgabe → Guide (+ Skripte)
| Aufgabe | Öffnen | Wichtige Skripte |
|---|---|---|
| Einheiten, Benennung, Collections, Asset-Bibliotheken, Batch-/Headless-Pipelines, Add-ons/Extensions | guides/01-scene-pipeline.md | scene_audit, batch_process, assets/addon_template |
| Hard-Surface, Fasen, Booleans, Weighted Normals, allgemeine Modellierung, prozedurale Modellierung | guides/02-modeling-hardsurface.md | apply_stack |
| Props, Kitbash, Möbel, Fahrzeuge, Mechs, Archviz | guides/03-props-vehicles-archviz.md | apply_stack, build_pbr_material |
| Sculpting, Multires, Remesh, Kreaturen, Monster | guides/04-sculpting-creatures.md | sculpt_ops |
| Menschliche Charaktere, Archetypen, Kleidung, Gesichts-Rig, ARKit/Viseme | guides/05-characters-clothing-face.md | garment, shapekeys |
| Haare, Fell, Hair-Cards | guides/06-hair-groom.md | groom |
| Retopologie, UV-Entfaltung, Texel-Dichte, UDIM, Lightmap-UV | guides/07-retopology-uv.md | auto_retopo, uv_pack, texel_density |
| PBR-Materialien, Abnutzung und Schmutz, Decals, Trim-Sheets, Baking | guides/08-materials-texturing-baking.md | build_pbr_material, smart_material, decal, bake_maps |
| Geometry Nodes, prozedurale Generatoren, Streuen | guides/09-geometry-nodes.md | gn_builder |
| Gelände, Biome, modulare Kits, Vegetation, Set-Dressing | guides/10-environments-vegetation.md | terrain, scatter, kit_check |
| Rigify, Skinning, Game-Skelette, Keyframes, NLA, MoCap-Retarget, Loops | guides/11-rigging-animation.md | rigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check |
| Starrkörper, Stoff, Flüssigkeiten, Zerstörung, VFX, Regen, Schnee, Blitz | guides/12-simulation-vfx-weather.md | sim_setup, precipitation, surface_weather, lightning |
| Beleuchtungs-Rigs, HDRI, Look-Dev, Kamera, Tageszeit, Nebel, Stimmungen | guides/13-lighting-camera-lookdev.md | turntable, scene_mood |
| Cycles/EEVEE-Einstellungen, Batch-Render, Compositor | guides/14-rendering-compositing.md | render_batch |
| Poly-Budgets, LODs, Draw-Calls, Collision-Proxies | guides/15-optimization-lod-collision.md | mesh_stats, make_lods |
| Export glTF/FBX/USD für Unity, Unreal, Godot, Roblox, Web/Three.js | guides/16-export-engines.md | export_asset, node/blender-threejs-export.js |
| QA vor der Auslieferung (immer) | guides/17-qa-review.md | qa_check, review_shots |
| Video-Sequencer-Bearbeitung, Motion Tracking, Kamera-Lösen | guides/18-video-editing-tracking.md | vse_edit, track_camera |
| Produktvideos: Drehteller, langsamer Zoom, Dolly, Kran, Speed-Ramp-Loop, perfekter Loop, Produkt-Polish | guides/19-product-camera-animations.md | node/blender-product-polish.js, turntable.py |
| Poly-Haven-HDRIs, Texturen, Studio-/Showroom-Szenen, Materialvarianten | guides/20-polyhaven-assets.md | node/polyhaven-*.js |
Foto(s) → texturiertes 3D-Modell (Meshy-API, benötigt MESHY_API_KEY) | guides/21-image-to-3d.md | danach auto_retopo, qa_check |
| End-to-End-Playbooks (Prop, Charakter, Roblox, Produkt-Shot) | guides/22-workflow-recipes.md | |
| Optionales externes WebSocket-Toolkit (Mixamo-Retarget über Dev-GOM-Add-on) | guides/23-websocket-toolkit.md | (nicht gebündelt) |
Stilrichtung: Öffnen Sie einen Abschnitt aus diesen Dateien, nicht die gesamte Datei.
| Stil-Frage | Öffnen |
|---|---|
| Stylisiert, realistisch, Low-Poly, Anime/Manga, Chibi, Cartoon, Comic, handbemalt, Pixel, Voxel, isometrisch, HD-2D, Retro 8/16-Bit, Noir, Toon/NPR, Konsolen-Ären (PS1–PS5, CRT/VHS) | styles/art-styles.md |
| Horror, PSX-Horror, Indie, Found-Footage, Body-Horror, Cosmic-Horror, Folk-Horror, Mascot-Horror, Liminal, Weirdcore | styles/horror.md |
| Fantasy, Sci-Fi/Punk, Apokalypse, Historisch, Biome, Gemütlich, Dark/Gritty, Surreal, Brutalistisch, Neon-Retrofuturismus | styles/worlds-moods.md |
| Genre-Art-Direction: Action, Card/Idle, Metroidvania, VN, Open World, Plattformer, Rennspiel, RPG, Shooter, Soulslike, Stealth, Strategie, Survival | styles/game-genres.md |
Themenspezifische Deep-Dive-Referenzen befinden sich in refs/<original-skill-name>/, und Guides verweisen direkt darauf.
5. Verifizieren (vor dem Melden von „erledigt“ erforderlich)
- Zahlen melden, keine Adjektive: Dreiecke, Objekte, Materialien, Abmessungen (
ob.dimensions) und die geschriebenen Ausgabedateien. - Wenn sich die Geometrie geändert hat,
scripts/qa_check.pyausführen (Z-Fighting, losgelöste Teile, nicht-manifold, umgekehrte Normalen, Maßstab). - Das Ergebnis betrachten: MCP
get_viewport_screenshot/lookoder headlessscripts/review_shots.pyKontaktabzüge. - Bei Game-Assets
scripts/mesh_stats.pygegen das Plattformbudget ausführen undrefs/shared/validation-checklist.mddurchgehen. - Bestätigen, dass exportierte Dateien existieren und ihre Größe nicht Null ist.