Communitygithub.com

Ultimate Blender

All-in-One-Skill für Blender 5.x, das alle Aufgaben rund um Blender, bpy, .blend oder 3D-Assets abdeckt – inklusive Modellierung, Sculpting, Retopo/UV, PBR, Baking, Rigging, Animation, Simulationen, VFX, Beleuchtung, Rendering, Game-Export, Produkt-Turntables, Poly Haven, Foto-zu-3D und über 90 Kunststile. Steuert Blender über blender-mcp oder headless CLI.

Was ist Ultimate Blender?

Dieses Skill vereint die Stärken dreier etablierter Packs: **el4cteo** (getestete bpy-Skripte + Blender-5.x-Regeln), **arjun988** (Technical-Art-Director-Workflow mit über 90 Spezialisten- und Stilrichtungen) und **kevinbadi** (Produktkamera-Animationen, Poly Haven, Meshy-Foto-zu-3D, Three.js-Export). Es ist für Entwickler konzipiert, die Blender über MCP (z. B. in Claude Code, Cursor oder Codex) oder headless via CLI steuern möchten. Der sechsteilige Director-Workflow (ANALYZE → PLAN → BRIEF → EXECUTE → VALIDATE → DELIVER) stellt sicher, dass jedes Asset von der Analyse bis zur Auslieferung professionell bearbeitet wird. Das Skill enthält eine umfangreiche Routingtabelle mit über 20 Guides, die fast jede erdenkliche Aufgabe abdecken – von Hard-Surface-Modellierung über Sculpting, Charaktere, Haare, Retopologie, PBR-Materialien, Geometry Nodes, Umgebungen, Rigging, Animation, Simulationen, VFX, Beleuchtung, Rendering, Optimierung, Export für Unity/Unreal/Godot/Roblox/Web, Poly Haven, Video-Editor, Motion-Tracking, Produkt-Turntables und sogar Foto-zu-3D über Meshy. Zusätzlich stehen über 90 Kunststile (von Anime bis Horror) zur Verfügung, die über eigene Stil-Guides abgerufen werden können.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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
  1. Analysieren: Asset-Zweck (Hero / Standard / Hintergrund), Ziel (Game / Kinofilm / Portfolio / Produktvideo), Plattform (Mobile / Konsole / PC / Web / Roblox), Stil, Animation (statisch / geriggt / animiert), Exportformat.
  2. Planen: Guides aus der Routingtabelle (Abschnitt 4) auswählen und die Polygon- und Texturbudgets festlegen (refs/shared/polycount-budgets.md).
  3. 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.
  4. Ausführen: Kleine Schritte über MCP oder headless ausführen (Abschnitt 2). Die gebündelten Skripte verwenden, bevor neuer Code geschrieben wird.
  5. Validieren: Abschnitt 5 befolgen. Dieser Schritt ist erforderlich.
  6. 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.attributes und foreach_get/set mit 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.data ist im Edit-Modus veraltet. bmesh.from_edit_mesh + update_edit_mesh verwenden oder zuerst in den OBJECT-Modus wechseln.
  • Nodes: Nach type suchen ("BSDF_PRINCIPLED"), niemals nach name, da Namen lokalisiert sind.
  • Enums: Aus bl_rna.properties[p].enum_items lesen. Für dynamische Enums (render.engine, view_transform) innerhalb von try/except TypeError zuweisen.
  • Engines: BLENDER_EEVEE, CYCLES, BLENDER_WORKBENCH. GPU: scene.cycles.device="GPU" + die Voreinstellungen compute_device_type.
  • Evaluated Mesh: ob.evaluated_get(dg).to_mesh(), dann immer to_mesh_clear(). view_layer.update() vor dem Lesen von matrix_world aufrufen.
  • 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_settings aufrufen, 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+). bgl existiert nicht mehr. Der Sculpt-Modus stürzt in -b ab, daher scripts/sculpt_ops.py verwenden.
  • 5.x-API-Brüche: action.fcurves → Channelbags · scene.node_tree → scene.compositing_node_group · material.use_nodes veraltet · mod["Socket_2"] → mod.properties.inputs.Socket_2.value · BLENDER_EEVEE_NEXT → BLENDER_EEVEE · Boolean FAST → FLOAT · Bone-Layer → Bone-Collections · bl_info → blender_manifest.toml · 5.3: Compositor-Effekte-Stapel, VSE EXPAND → 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ÖffnenWichtige Skripte
Einheiten, Benennung, Collections, Asset-Bibliotheken, Batch-/Headless-Pipelines, Add-ons/Extensionsguides/01-scene-pipeline.mdscene_audit, batch_process, assets/addon_template
Hard-Surface, Fasen, Booleans, Weighted Normals, allgemeine Modellierung, prozedurale Modellierungguides/02-modeling-hardsurface.mdapply_stack
Props, Kitbash, Möbel, Fahrzeuge, Mechs, Archvizguides/03-props-vehicles-archviz.mdapply_stack, build_pbr_material
Sculpting, Multires, Remesh, Kreaturen, Monsterguides/04-sculpting-creatures.mdsculpt_ops
Menschliche Charaktere, Archetypen, Kleidung, Gesichts-Rig, ARKit/Visemeguides/05-characters-clothing-face.mdgarment, shapekeys
Haare, Fell, Hair-Cardsguides/06-hair-groom.mdgroom
Retopologie, UV-Entfaltung, Texel-Dichte, UDIM, Lightmap-UVguides/07-retopology-uv.mdauto_retopo, uv_pack, texel_density
PBR-Materialien, Abnutzung und Schmutz, Decals, Trim-Sheets, Bakingguides/08-materials-texturing-baking.mdbuild_pbr_material, smart_material, decal, bake_maps
Geometry Nodes, prozedurale Generatoren, Streuenguides/09-geometry-nodes.mdgn_builder
Gelände, Biome, modulare Kits, Vegetation, Set-Dressingguides/10-environments-vegetation.mdterrain, scatter, kit_check
Rigify, Skinning, Game-Skelette, Keyframes, NLA, MoCap-Retarget, Loopsguides/11-rigging-animation.mdrigify_build, bind_mesh, rig_check, stress_poses, retarget, bake_action, loop_check
Starrkörper, Stoff, Flüssigkeiten, Zerstörung, VFX, Regen, Schnee, Blitzguides/12-simulation-vfx-weather.mdsim_setup, precipitation, surface_weather, lightning
Beleuchtungs-Rigs, HDRI, Look-Dev, Kamera, Tageszeit, Nebel, Stimmungenguides/13-lighting-camera-lookdev.mdturntable, scene_mood
Cycles/EEVEE-Einstellungen, Batch-Render, Compositorguides/14-rendering-compositing.mdrender_batch
Poly-Budgets, LODs, Draw-Calls, Collision-Proxiesguides/15-optimization-lod-collision.mdmesh_stats, make_lods
Export glTF/FBX/USD für Unity, Unreal, Godot, Roblox, Web/Three.jsguides/16-export-engines.mdexport_asset, node/blender-threejs-export.js
QA vor der Auslieferung (immer)guides/17-qa-review.mdqa_check, review_shots
Video-Sequencer-Bearbeitung, Motion Tracking, Kamera-Lösenguides/18-video-editing-tracking.mdvse_edit, track_camera
Produktvideos: Drehteller, langsamer Zoom, Dolly, Kran, Speed-Ramp-Loop, perfekter Loop, Produkt-Polishguides/19-product-camera-animations.mdnode/blender-product-polish.js, turntable.py
Poly-Haven-HDRIs, Texturen, Studio-/Showroom-Szenen, Materialvariantenguides/20-polyhaven-assets.mdnode/polyhaven-*.js
Foto(s) → texturiertes 3D-Modell (Meshy-API, benötigt MESHY_API_KEY)guides/21-image-to-3d.mddanach 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, Weirdcorestyles/horror.md
Fantasy, Sci-Fi/Punk, Apokalypse, Historisch, Biome, Gemütlich, Dark/Gritty, Surreal, Brutalistisch, Neon-Retrofuturismusstyles/worlds-moods.md
Genre-Art-Direction: Action, Card/Idle, Metroidvania, VN, Open World, Plattformer, Rennspiel, RPG, Shooter, Soulslike, Stealth, Strategie, Survivalstyles/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)

  1. Zahlen melden, keine Adjektive: Dreiecke, Objekte, Materialien, Abmessungen (ob.dimensions) und die geschriebenen Ausgabedateien.
  2. Wenn sich die Geometrie geändert hat, scripts/qa_check.py ausführen (Z-Fighting, losgelöste Teile, nicht-manifold, umgekehrte Normalen, Maßstab).
  3. Das Ergebnis betrachten: MCP get_viewport_screenshot / look oder headless scripts/review_shots.py Kontaktabzüge.
  4. Bei Game-Assets scripts/mesh_stats.py gegen das Plattformbudget ausführen und refs/shared/validation-checklist.md durchgehen.
  5. Bestätigen, dass exportierte Dateien existieren und ihre Größe nicht Null ist.

Verwandte Skills