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), undmujoco-studio-sidecar/SKILL.mddamit 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: Erzwingt0Gelenke, 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).
-
Wenn du das Top-Level- / Eltern-Gespräch bist:
- Erstelle einen
self-Subagenten (Model: "inherit") überinvoke_subagent, um das Asset zu erstellen und zu verifizieren und übergib alle benutzerspezifischen Anweisungen, URLs und Überschreibungen, dieParent Conversation ID: <parent_conv_id>und das Ziel-Asset-Ausgabe-Elternverzeichnis. Weise den Subagenten an, dieseblender-creation-Fähigkeit zu lesen, [rules/mujoco_asset_standards.md][asset-standards],mujoco-audit/SKILL.mdundmujoco-showcase-shot/SKILL.md. Weise den Subagenten nicht an, Scratch-/Aufnahmedateien in dasbrain/<parent_conv_id>/-Verzeichnis des Eltern-Gesprächs zu schreiben (macOS Seatbelt-Sandboxing blockiert konversationsübergreifendenbrain/-Zugriff mitPermissionError); 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). Startestudiod.pyvom 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 mitFast (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/)(plushttp://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.
- Erstelle einen
-
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 sandboxierterun_command-Schritte lokalen Lese-/Schreibzugriff ohnePermissionErrorhaben. 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ächstudiod.pystartet und den Studio-Link präsentiert. - Stelle sicher, dass
uvund Headless Blender (4.2+) lokal installiert sind (macOS & Linux):Führe Blender-Skripte aus mituv --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)PYTHONDONTWRITEBYTECODE=1 "$BLENDER_BIN" -b -P <ArtifactDir>/scratch/build_asset.pyund füge<PLUGIN_DIR>/skills/blender-creation/scriptszusys.pathinnerhalb des Blender-Skripts hinzu, umimport blender_mesh_utils as bmuzu ermöglichen. - MuJoCo-Kompilierung, Filament-Showcase-Renderings & Referenzaufnahme (
uv run):
Füge innerhalb deines Scratch-Skripts die Plugin-Skript-Verzeichnisse (uv run --with mujoco --with numpy --with scipy --with trimesh --with Pillow \ python3 <ArtifactDir>/scratch/script.py<PLUGIN_DIR>/skills/blender-creation/scripts,<PLUGIN_DIR>/skills/mujoco-audit/scriptsund<PLUGIN_DIR>/skills/mujoco-showcase-shot/scripts) zusys.pathhinzu, umasset_build_utils as abu,audit_scenariosundrender_showcase_shotzu importieren. - Scope & Arbeitsbereichshygiene:
- Führe standardmäßig die
audit_scenarios10-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 explizitSkip Physics AuditoderFast Auditangibt. Generiere kein zweites<asset_name>_mechanical/-Bündel, es sei denn, es wird angefordert. Verifiziere saubere statischeMjModel-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__,.venvoderstudiod-Gerüst-/Laufzeitdateien in das Asset-Verzeichnis.
- Führe standardmäßig die
- Beachte die Überschreibungen der Regler:
Articulations: Rigid-Only->0Gelenke;Depth: Fast (No Turntable)-> Schritt 7.4 überspringen;Skip Physics Audit/Fast Audit-> Schritt 7.3 überspringen.
- Erstelle keinen verschachtelten Build-Subagenten—führe Abschnitte 1.1 bis 7.5 direkt aus (du kannst den schreibgeschützten
1.1 Aufnahme, Referenz-Kontakt-/Detailblätter & Formular-Kurzbericht
- Produkt-URL- & Referenzaufnahme (
<= 8Bildlesevorgä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:
- 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 × Hinmmund Nettoproduktmasse inkg, kreuzgeprüft mit demItem Weightdes Einzelhandels vs. dem Versandgewicht). - Identifiziere hochauflösende Produktgalerie- / Karussellbild-URLs.
- Extrahiere den verifizierten Produkttitel, Materialien, Mechanismusbeschreibungen und Maßspezifikationen (
- 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.
- Lade die gesammelten hochauflösenden Galeriebilder in
<ArtifactDir>/scratch/intake/ref_*.jpgherunter (z.B. mitcurloder einem minimalen Inline-Download-Skript).
- Rufe den schreibgeschützten
- Wenn keine URL bereitgestellt wird (nur Textabfrage): Suche nach Nettoprodukt
L x B x H(mm) und Masse (kg) übersearch_web(oder rufe denbrowser-Subagenten auf, wennsearch_webnur nackte Weiterleitungslinks ohne Textauszüge zurückgibt). Kreuze dasItem Weightdes Einzelhandels mit Abmessungen und Materialdichte ab. - Zusammengesetzte Blätter (
<= 8Bildlesevorgänge): Rufe niemalsread_filefür Dutzende einzelner Frames auf. Füge die heruntergeladenenref_*.jpg-Fotos und Submerkmal-Ausschnitte inref_contact_sheetundref_details_gridüberabu.build_ref_contact_and_detail_sheetszusammen und untersuche dann diese zusammengesetzten Blätter mitread_file.
- Rate niemals die Produktidentität, Kategorie oder Abmessungen aus einem URL-Pfad-Slug (z.B. kann
- 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"). Übergibrgb_sample_boxes=[('main_shell', ref_path, (x0, y0, x1, y1)), ...]anabu.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).
- Erfinde keine
- Schreibe einen
<= 25-zeiligen Formular-Kurzbericht & benannten ParameterblockP(<= 40benannte Dimensionen):- Schreibe vor dem Schreiben von Blender
bmesh-Code einen prägnanten Formular-Kurzbericht und definiere ein benanntes Parameter-WörterbuchP = dict(...)(<= 40benannte Dimensionen inmm/munddegmit 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- (
+Yvs.-Y) und Vorne-/Hinten- (+Xvs.-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
moderrad.
- Schreibe vor dem Schreiben von Blender
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, ausscripts/blender_mesh_utils.py):bmu.clear_scene() -> Nonebmu.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.Materialbmu.skin_skeleton(name, nodes_xyzr, edges=None, *, subsurf_levels=2) -> objbmu.metaball_sdf(name, elements, *, resolution=0.002) -> objbmu.swept_tube(name, points_xyzr, *, bevel_resolution=6) -> objbmu.voxel_smooth_union(name, objects, *, voxel_size=0.0015, smooth_iterations=6) -> objbmu.apply_boolean_cutter(target_obj, cutter_obj, *, operation='DIFFERENCE', solver='MANIFOLD') -> objbmu.smart_seam_unwrap(target_obj, *, angle_limit_deg=66.0, margin=0.005) -> objbmu.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) -> Nonebmu.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_objbmu.bake_pbr_maps(out_dir, *, material_groups=None, resolution=1024, samples=8) -> {key: {'basecolor', 'roughness', 'metallic', 'normal'}}
asset_build_utils as abu(innerhalb vonuv run-Skripten, ausscripts/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) -> dictabu.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) -> dictabu.dilate_uv_gutters(arr, valid_mask, *, max_dist_px=12) -> np.ndarrayabu.triplanar_project_map(map_2d, xyz, world_normal, *, texels_per_meter=4000.0, sharpness=4.0) -> np.ndarrayabu.height_to_normal_rgb(height_map, strength=3.5, *, smooth_sigma=0.0, valid_mask=None) -> (H,W,3) uint8abu.normal_rgb_from_3d_height_fn(height_fn, uv_world_fields, *, step_mm=0.15, strength=1.0) -> (H,W,3) uint8abu.fbm_noise_3d(xyz, *, base_freq=25.0, wavelength_mm=None, octaves=4, per
…
[gekürzt für die Übersetzung]