CommunityCodierung & Entwicklunggithub.com

blender-creation

Erstellt physikalisch kalibrierte, artikulierte, PBR-texturierte 3D-MuJoCo-Assets (MJCF-model.xml, .mjz, mjSpec) von Grund auf mit headless Blender (bpy, bmesh, blender_mesh_utils, asset_build_utils), konvexer Kollisionssynthese, 10-Szenario-Audit und Studio-Vorschau. Nur verwenden, wenn ein 3D-MuJoCo-Objekt aus einer URL, einem Bild oder einer Textbeschreibung erstellt, modelliert oder gebaut werden soll, oder wenn blender-creation namentlich genannt wird. Nicht für Nicht-MuJoCo-Blender/Cycles/CAD-Modellierung verwenden.

Was ist blender-creation?

Diese Fähigkeit ermöglicht es, vollständige, bewegliche und physikalisch korrekte 3D-Assets für die MuJoCo-Simulationsumgebung direkt aus Textbeschreibungen, Bildern oder Produkt-URLs zu generieren. Der gesamte Prozess läuft in Blender im Hintergrundmodus (headless) ab, wobei vordefinierte Python-Skripte (`blender_mesh_utils`, `asset_build_utils`) für die Modellierung, Texturierung und den Export genutzt werden. Ein besonderer Fokus liegt auf der Einhaltung der MuJoCo-Koordinatenstandards, der SI-Einheiten und der physikalischen Plausibilität, was durch ein automatisiertes Audit mit zehn dynamischen Szenarien überprüft wird. Die erzeugten Assets enthalten PBR-Texturen (Physically Based Rendering), konvexe Kollisionshüllen für effiziente Physiksimulation und sind für die Verwendung in MuJoCo Studio optimiert. Die Fähigkeit unterstützt Optionen wie "Fast" (ohne Showcase-Video), "Rigid-Only" (keine Gelenke) und "Skip Physics Audit" (überspringt die dynamische Simulation), um den Workflow an die Benutzerbedürfnisse anzupassen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/google-deepmind/robotics-antigravity-plugin/tree/HEAD/plugins/robotics/skills/blender-creation

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

3D-MuJoCo-Assets von Grund auf in Blender erstellen (bpy / bmesh + PBR)

[!WICHTIG]

Ergänzung zu [rules/mujoco_asset_standards.md][asset-standards]: Lies zuerst [rules/mujoco_asset_standards.md][asset-standards] für die verbindlichen MuJoCo-Koordinatenrahmen (UP_POSZ_FORWARD_POSX_RIGHT_NEGY), SI-Einheitenregeln, Gruppenaufteilung (group="2" visuell, group="3" Kollision, group="4" Sites) und Physik-/Auditanforderungen. Diese Anleitung behandelt, wie man neue Assets von Grund auf mit headless Blender recherchiert, vermisst, modelliert, formt, UV-entfaltet, texturiert, backt, exportiert, verifiziert und interaktiv in der Vorschau betrachtet. (PYTHONDONTWRITEBYTECODE=1 "$BLENDER_BIN" -b -P ...), scripts/blender_mesh_utils.py (bmu), scripts/asset_build_utils.py (abu), mujoco-audit/SKILL.md, mujoco-showcase-shot/SKILL.md (render_showcase_shot.py), und mujoco-studio-sidecar/SKILL.md damit sie im MuJoCo Filament PBR-Renderer und MuJoCo Studio korrekt aussehen, sich verhalten und inspizieren lassen.


1. Einstiegspunkt, Subagenten-Orchestrierung, Lokale Blender-Einrichtung & Referenzaufnahme

1.0 Aufruf, Standardeinstellungen & Subagenten-Orchestrierung

Benutzer rufen diese Fähigkeit in natürlicher Sprache mit einer Produkt-URL, Referenzbild(ern) oder Textspezifikationen auf:

"Erstelle ein 3D-MuJoCo-Asset für diese Küchenzange: <url>" "Folge blender-creation, um das Objekt in <image/link> zu modellieren"

Standardeinstellungen & Optionale Überschreibungen: Standardmäßig führt die Fähigkeit die vollständige End-to-End-Pipeline aus: automatisch erkannte Artikulationen, diagnostische Zwischenrenderings, 10-Szenario-dynamische Physiksimulationsaudit (§7.3) und ein 360°-Filament-Drehteller-Showcase-Video (§7.4). Benutzer können optional Überschreibungen in einfachem Englisch oder als Aufzählungspunkte anfordern:

  • Fast / No Turntable: Überspringt das Showcase-Video-Rendering in Schritt 7.4 (spart Renderzeit).
  • Rigid-Only: Erzwingt 0 Gelenke, das Objekt wird als einzelner starrer Körper erstellt.
  • Skip Physics Audit / Fast Audit: Überspringt die 10-Szenario-dynamische Physiksimulationssuite in Schritt 7.3 (verlässt sich nur auf die statische Hygiene- und Kollisionsausrichtungsprüfungen von Schritt 7.1).
  1. Wenn du das Top-Level- / Eltern-Gespräch bist:

    • Erstelle einen self-Subagenten (Model: "inherit") über invoke_subagent, um das Asset zu erstellen und zu verifizieren und übergib alle benutzerspezifischen Anweisungen, URLs und Überschreibungen, die Parent Conversation ID: <parent_conv_id> und das Ziel-Asset-Ausgabe-Elternverzeichnis. Weise den Subagenten an, diese blender-creation-Fähigkeit zu lesen, [rules/mujoco_asset_standards.md][asset-standards], mujoco-audit/SKILL.md und mujoco-showcase-shot/SKILL.md. Weise den Subagenten nicht an, Scratch-/Aufnahmedateien in das brain/<parent_conv_id>/-Verzeichnis des Eltern-Gesprächs zu schreiben (macOS Seatbelt-Sandboxing blockiert konversationsübergreifenden brain/-Zugriff mit PermissionError); lass den Subagenten sein eigenes <ArtifactDir>/scratch/ verwenden und die Pfade zum fertigen Asset und zur Vorschau zurückgeben.
    • Wenn der Subagent fertig ist: Folge Schritt 7.6 (mujoco-studio-sidecar/SKILL.md) im Top-Level-Gespräch, um den MuJoCo Studio Web-Seitencar-Dienst (studiod.py) zu starten (oder wiederzuverwenden), der auf das fertige Asset-Verzeichnis zeigt (--workspace_dir=<asset_dir>), und verifiziere /_studio/status ("ok": true, "daemon_connected": true). Starte studiod.py vom Top-Level-Gespräch aus, nicht innerhalb des Builder-Subagenten, damit der Hintergrundprozess nicht beendet wird, wenn der Subagent beendet wird. Präsentiere in deiner endgültigen Antwort zuerst den Pfad zum fertigen Asset, die Modellzusammenfassung (Abmessungen, Masse, Gelenke, visuelle/Kollisionsaufteilung, Audit-Status), einen Side-by-Side-Vergleich und das Drehteller-Video (es sei denn, es wurde mit Fast (No Turntable) übersprungen, vermerke kurz in einer 1-zeiligen Bildunterschrift, dass der Film eine 360°-Textur-Visuall-Ansicht gefolgt von einer durchscheinenden Physik-Kollisionshüllen-Inspektion zeigt), und setze [MuJoCo Studio](sidecar://robotics/mujoco_studio/) (plus http://127.0.0.1:<http_port>/ aus $SESSION_FILE, wenn der Node-Seitencar-Proxy nicht aktiv ist) als allerletzten Punkt am unteren Ende deiner Antwort, damit die interaktive Seitencar-Pille niemals oben übersehen wird.
  2. Wenn du bereits der erstellte Haupt-Builder-Subagent bist:

    • Erstelle keinen verschachtelten Build-Subagenten—führe Abschnitte 1.1 bis 7.5 direkt aus (du kannst den schreibgeschützten browser-Subagenten während Schritt 1.1 aufrufen, wenn eine Produkt-URL clientseitiges JS-Rendering erfordert). Behalte alle Scratch-/Aufnahmedateien im eigenen <ArtifactDir>/scratch/ dieses Subagenten, damit sandboxierte run_command-Schritte lokalen Lese-/Schreibzugriff ohne PermissionError haben. Führe Schritt 7.6 (studiod.py) nicht innerhalb des Subagenten aus; gib stattdessen den Pfad zum fertigen <asset_dir>, die Modellzusammenfassung, Vergleichsbilder und den Pfad zum Drehteller-Video an das Eltern-Gespräch zurück, damit das Eltern-Gespräch studiod.py startet und den Studio-Link präsentiert.
    • Stelle sicher, dass uv und Headless Blender (4.2+) lokal installiert sind (macOS & Linux):
      uv --version
      if [ -x "/Applications/Blender.app/Contents/MacOS/Blender" ]; then
        BLENDER_BIN="/Applications/Blender.app/Contents/MacOS/Blender"
      else
        BLENDER_BIN="blender"
      fi
      "$BLENDER_BIN" --version || (sudo apt-get update && sudo apt-get install -y blender)
      
      Führe Blender-Skripte aus mit PYTHONDONTWRITEBYTECODE=1 "$BLENDER_BIN" -b -P <ArtifactDir>/scratch/build_asset.py und füge <PLUGIN_DIR>/skills/blender-creation/scripts zu sys.path innerhalb des Blender-Skripts hinzu, um import blender_mesh_utils as bmu zu ermöglichen.
    • MuJoCo-Kompilierung, Filament-Showcase-Renderings & Referenzaufnahme (uv run):
      uv run --with mujoco --with numpy --with scipy --with trimesh --with Pillow \
        python3 <ArtifactDir>/scratch/script.py
      
      Füge innerhalb deines Scratch-Skripts die Plugin-Skript-Verzeichnisse (<PLUGIN_DIR>/skills/blender-creation/scripts, <PLUGIN_DIR>/skills/mujoco-audit/scripts und <PLUGIN_DIR>/skills/mujoco-showcase-shot/scripts) zu sys.path hinzu, um asset_build_utils as abu, audit_scenarios und render_showcase_shot zu importieren.
    • Scope & Arbeitsbereichshygiene:
      • Führe standardmäßig die audit_scenarios 10-Szenario-Physik-Fall-/Kipp-/Greifsimulationen (Schritt 7.3) aus und verifiziere, dass alle Szenarien bestehen (oder behebe fehlschlagende Prüfungen gemäß mujoco-audit/SKILL.md). Überspringe dynamische Simulationen nur, wenn der Benutzer explizit Skip Physics Audit oder Fast Audit angibt. Generiere kein zweites <asset_name>_mechanical/-Bündel, es sei denn, es wird angefordert. Verifiziere saubere statische MjModel-Kompilierung, rückseitenfreie Normalen (abu.render_blender_diagnostic_sheet), Kollisionsausrichtung (audit_scenarios.compute_collision_alignment_summary), kinematische Gelenkpositionen (Articulations: Auto) und alle dynamischen Physik-Fall-/Kipp-/Setz-Szenarien.
      • Behalte alle Scratch-Skripte, heruntergeladenen Referenzfotos, Zwischennetze, diagnostischen .jpg/.png-Blätter, .blend-Dateien, virtuelle Umgebungen (.venv) und Caches in <ArtifactDir>/scratch/, ~/.venvs/ und ~/.cache/mujoco_pbr_cache. Schreibe nur die endgültigen Asset-Ergebnisse (model.xml, meshes/*.obj, textures/*.png) in das Ziel-Asset-Verzeichnis und schreibe niemals .pyc / __pycache__, .venv oder studiod-Gerüst-/Laufzeitdateien in das Asset-Verzeichnis.
    • Beachte die Überschreibungen der Regler: Articulations: Rigid-Only -> 0 Gelenke; Depth: Fast (No Turntable) -> Schritt 7.4 überspringen; Skip Physics Audit / Fast Audit -> Schritt 7.3 überspringen.

1.1 Aufnahme, Referenz-Kontakt-/Detailblätter & Formular-Kurzbericht

  1. Produkt-URL- & Referenzaufnahme (<= 8 Bildlesevorgänge):
    • Rate niemals die Produktidentität, Kategorie oder Abmessungen aus einem URL-Pfad-Slug (z.B. kann /Walnut-Elegant-Design-Coffee-Products/dp/... ein abgeschnittener SEO-Slug und kein Couchtisch sein).
    • Wenn eine Produkt-URL bereitgestellt wird:
      1. Rufe den schreibgeschützten browser-Subagenten auf, um im Namen des Benutzers zu <product_url> zu navigieren. Untersuche die live gerenderte Seite so, wie es ein menschlicher Designer tun würde:
        • Extrahiere den verifizierten Produkttitel, Materialien, Mechanismusbeschreibungen und Maßspezifikationen (L × B × H in mm und Nettoproduktmasse in kg, kreuzgeprüft mit dem Item Weight des Einzelhandels vs. dem Versandgewicht).
        • Identifiziere hochauflösende Produktgalerie- / Karussellbild-URLs.
      2. Wenn der Zugriff durch ein interaktives CAPTCHA oder Sicherheitsgate blockiert wird: stoppe ohne zu versuchen, das Gate zu umgehen, und frage den Benutzer direkt nach den Produktabmessungen, Spezifikationen oder Referenzfotos.
      3. Lade die gesammelten hochauflösenden Galeriebilder in <ArtifactDir>/scratch/intake/ref_*.jpg herunter (z.B. mit curl oder einem minimalen Inline-Download-Skript).
    • Wenn keine URL bereitgestellt wird (nur Textabfrage): Suche nach Nettoprodukt L x B x H (mm) und Masse (kg) über search_web (oder rufe den browser-Subagenten auf, wenn search_web nur nackte Weiterleitungslinks ohne Textauszüge zurückgibt). Kreuze das Item Weight des Einzelhandels mit Abmessungen und Materialdichte ab.
    • Zusammengesetzte Blätter (<= 8 Bildlesevorgänge): Rufe niemals read_file für Dutzende einzelner Frames auf. Füge die heruntergeladenen ref_*.jpg-Fotos und Submerkmal-Ausschnitte in ref_contact_sheet und ref_details_grid über abu.build_ref_contact_and_detail_sheets zusammen und untersuche dann diese zusammengesetzten Blätter mit read_file.
  2. Photometrische RGB-Perzentile direkt aus Referenz-Ausschnitten abtasten (rgb_sample_boxes):
    • Erfinde keine RGB-Werte aus verbalen Kategorienamen ("rotes Plastik", "schwarzer Gummi", "grüner Plüsch"). Übergib rgb_sample_boxes=[('main_shell', ref_path, (x0, y0, x1, y1)), ...] an abu.build_ref_contact_and_detail_sheets, um [p25, p50, p75] sRGB-Tupel direkt von gleichmäßigen inneren Oberflächenflecken zu messen (ohne spekulare Hotspots und Wurfflächen).
  3. Schreibe einen <= 25-zeiligen Formular-Kurzbericht & benannten Parameterblock P (<= 40 benannte Dimensionen):
    • Schreibe vor dem Schreiben von Blender bmesh-Code einen prägnanten Formular-Kurzbericht und definiere ein benanntes Parameter-Wörterbuch P = dict(...) (<= 40 benannte Dimensionen in mm / m und deg mit Herkunftskommentaren), anstatt hunderte magischer Koordinatentupel fest zu codieren:
      • Benannte Primäroberflächen & wie sie aufeinandertreffen: Seitenkontur-Facetten/Winkel, Draufsicht-Verjüngung, Kronenquerschnitt, Negativraum / offene Tageslücken zwischen Teilen und bündige vs. abgesetzte Verbindungen.
      • Links-/Rechts- (+Y vs. -Y) und Vorne-/Hinten- (+X vs. -X) Asymmetrie: notiere explizit, welche Hebel, Clips, Knöpfe, Etiketten oder Anschlüsse auf jeder Seite erscheinen.
      • Materialbereiche & Trennlinien: z.B. Zweikomponentenumspritzung, bei der starres ABS den inneren Kern und exponierte bündige Ränder bildet, während mattes TPE die äußere Grifffläche bildet, oder vertiefte Brandingtaschen.
      • Mechanismen & Bewegungen: bewegliche Unterteile (Scharnierdeckel, Schieber, Clips, Klingen, Knöpfe, Knäufe) mit echtem physikalischem Drehpunkt/Achse und Bewegung in m oder rad.

2. Werkzeugreferenz & Ziel-Renderer-Regeln

2.1 Kurze Hilfs-API-Referenz (blender_mesh_utils, asset_build_utils, render_showcase_shot)

  • blender_mesh_utils as bmu (innerhalb von headless Blender "$BLENDER_BIN" -b -P, aus scripts/blender_mesh_utils.py):
    • bmu.clear_scene() -> None
    • bmu.assign_pbr_material(objects, name=None, *, base_color=None, base_color_srgb=(200, 200, 200), roughness=0.4, metallic=0.0, normal_bump_mm=0.0, bump_height_mm=0.0, bump_scale=250.0) -> bpy.types.Material
    • bmu.skin_skeleton(name, nodes_xyzr, edges=None, *, subsurf_levels=2) -> obj
    • bmu.metaball_sdf(name, elements, *, resolution=0.002) -> obj
    • bmu.swept_tube(name, points_xyzr, *, bevel_resolution=6) -> obj
    • bmu.voxel_smooth_union(name, objects, *, voxel_size=0.0015, smooth_iterations=6) -> obj
    • bmu.apply_boolean_cutter(target_obj, cutter_obj, *, operation='DIFFERENCE', solver='MANIFOLD') -> obj
    • bmu.smart_seam_unwrap(target_obj, *, angle_limit_deg=66.0, margin=0.005) -> obj
    • bmu.smart_uv_project(objects, *, angle_limit_deg=66.0, island_margin=0.01, margin=None) -> list[obj]
    • bmu.pack_shared_uv_atlas(objs, *, margin=0.005, rotate=True, align_minimal_bbox=True, match_3d_area=True) -> None
    • bmu.finalize_and_export_obj(target_obj, out_obj_path, *, crease_deg=None, world_pos=None, body_pos=None, ensure_uvs=True) -> {'verts', 'quads', 'tris', 'earclipped_ngons'}
    • bmu.export_convex_hull_col(source_obj_or_points, out_obj_path, *, clip_bounds_world_m=None, clip_bounds_m=None, max_verts=64, name=None, world_pos=(0,0,0), body_pos=None) -> col_obj
    • bmu.bake_pbr_maps(out_dir, *, material_groups=None, resolution=1024, samples=8) -> {key: {'basecolor', 'roughness', 'metallic', 'normal'}}
  • asset_build_utils as abu (innerhalb von uv run-Skripten, aus scripts/asset_build_utils.py):
    • abu.build_ref_contact_and_detail_sheets(ref_paths, detail_crops, out_contact_png, out_details_png, *, raw_crops_dir=None, rgb_sample_boxes=None, cols=3, cell_size=440, include_shadow_lift=False) -> dict
    • abu.fetch_ambientcg_maps(asset_id, *, cache_dir=None, resolution='1K') -> {'color', 'roughness', 'normal_gl', 'metallic', 'ao', 'opacity', ...}
    • abu.rasterize_uv_world_fields(obj_paths, canvas_size=1024, *, part_offsets=None) -> dict
    • abu.dilate_uv_gutters(arr, valid_mask, *, max_dist_px=12) -> np.ndarray
    • abu.triplanar_project_map(map_2d, xyz, world_normal, *, texels_per_meter=4000.0, sharpness=4.0) -> np.ndarray
    • abu.height_to_normal_rgb(height_map, strength=3.5, *, smooth_sigma=0.0, valid_mask=None) -> (H,W,3) uint8
    • abu.normal_rgb_from_3d_height_fn(height_fn, uv_world_fields, *, step_mm=0.15, strength=1.0) -> (H,W,3) uint8
    • abu.fbm_noise_3d(xyz, *, base_freq=25.0, wavelength_mm=None, octaves=4, per

…

[gekürzt für die Übersetzung]

Verwandte Skills