# Findings 2026-10-31 – AutoRigPro, Skater-Rig und Asset-Pipeline ## Ziel Prüfen, ob sich die GenAI-Skaterin mit AutoRigPro in Blender 5.2 riggen lässt, ob der Export nach Godot trägt und wie die externen Assets reproduzierbar ins Projekt kommen. ## Ausgangsdatei `workbench_rinkplanner/inbox/figure_skater_blades_aligned.glb` | Eigenschaft | Wert | | :--- | :--- | | Mesh | 8.188 Vertices, 13.956 Dreiecke, 1 Objekt | | Topologie | 37 zusammenhängende Inseln, 2.346 offene/Non-Manifold-Kanten | | Texturen | 3 × 2048² PNG (BaseColor, Normal, MetallicRoughness) | | Maße | 1,66 × 0,35 × 1,90 m, Füße bei Z = 0 | | Ausrichtung | T-Pose, Blick +Z, Pivot Körpermitte | | Animation | keine, kein Skelett | ## AutoRigPro - ARP liegt als Blender-5.2-Extension unter `~/.config/blender/5.2/extensions/superhivemarket_com/`. - Die AI-Marker-Dateien fehlen (`~/Dokumente/AutoRigPro/AI` existiert nicht). Die Marker wurden deshalb skriptbasiert gesetzt: Neck, Chin, Head Tip, Root, Thigh, Knee, Foot, Shoulder, Elbow, Hand, Hand Tip. - Smart Rig mit `arp_smart_sym = True`, Finger aus, Bind-Engine `PSEUDO_VOXELS`. - Ergebnis: 226-Bone-Control-Rig, 33 Deform-Bones, Bindung in 1,3 s. ### Befund: erste Platzierung war falsch Der erste Lauf setzte die Beinkette zu weit außen: | Knochen | erster Lauf | korrekt | | :--- | ---: | ---: | | Fuß x | 0,24 | 0,10 | | Knie x | 0,17 | 0,095 | | Hand z | 1,17 | 1,50 | Die Reference-Bones waren bereits korrekt; nur die Deform-/IK-Kette wich ab. **`arp.match_to_rig` („Match to Rig")** baut die Deform-Kette aus den Reference-Bones neu, aktualisiert die Gewichte und setzt die Armature-Scale auf 1,0. Danach sitzen Fuß, Knie, Hand und Schulter exakt auf dem Mesh. Dieser Schritt ist bei diesem Mesh-Typ Pflicht. ### Testpose Arm hoch/tief, Bein gehoben, Kopf gedreht, Oberkörper geneigt. Rock, Haare und Schlittschuhe folgen ohne sichtbare Artefakte. Die Bindung wurde nicht manuell nachgearbeitet. ## Export | Variante | Bones | Größe | | :--- | ---: | ---: | | vollständiger Control-Rig | 226 | 8,41 MB | | nur Deform-Bones (`export_def_bones`) | 30 | 8,35 MB | Der Exporter meldet: - mehr als 4 Joint-Einflüsse → auf die 4 stärksten gekürzt und normalisiert - mehrere Shader-Tex-Image-Knoten → Sampler-Warnung, visuell unauffällig - Constraints nicht glTF-fähig → Animationen werden gebacken ## Godot - Import über `res://assets/external/characters/`. - `Skeleton3D` mit 30 Bones, eine skinnende `MeshInstance3D`, AABB 1,659 × 1,898 × 0,352 m, Material `model`. - Testclip `TestWave`: 2,0 s, 90 Kanäle (3 pro Joint), als `AnimationPlayer` mit Länge 2,0 s importiert und bei t = 1,0 gerendert. - Prüfwerkzeuge: `tests/manual/inspect_rig.gd`, `tests/manual/capture_rig.gd`. ## Asset-Pipeline - `assets/asset_manifest.json` beschreibt ID, Quelle, Ziel, SHA-256, Größe, Platzierung und Rig-Metadaten. - `tools/sync_assets.sh --check|--sync [--force]` prüft Quelle und Ziel gegen den Hash, kopiert nach `assets/external/` und importiert in Godot. - `assets/external/` ist gitignored. - Die Phase-1-Export-Presets schließen `assets/external/*` aus; 3D-Builds brauchen ein eigenes Preset. - Neuer Test `tests/run_asset_manifest_tests.gd`: 48 Assertions für Schema, Pfade, Platzierung, Rig-Daten und optional die synchronisierte Datei. - Gesamtsuite: **1123 Assertions** grün. ## Dateien ``` workbench/source/characters/skater/ ├── skater_rig_v002.blend # Produktions-Rig, ohne Testaktion ├── skater_anim_test.blend # Rig + TestWave ├── skater_rig_v001.blend # erster Lauf (vergleichen) └── skater_rig_test_01.blend # vor dem Rig workbench/library/characters/ ├── skater_figure_rigged_deform_v002.glb # 30 Bones, 8,35 MB ├── skater_figure_anim_test_v001.glb # + TestWave └── ... (Vergleichsversionen) ``` ## Entscheidungen - **D13:** 3D-Assets bleiben extern; das Repo hält Manifest und Sync-Werkzeug. - Der Produktions-Rig bleibt im `.blend`; exportiert werden nur Deform-Bones. - Animationen werden beim glTF-Export gebacken, nicht als Constraints mitgeschleppt. - Der Testclip bleibt aus dem Produktions-Rig und aus dem Manifest. ## Offen - 3D-Rink und Skater im Godot-Prototyp bewegen (Kurven-Sampling aus Phase 1). - Rotoscoping-Workflow: Referenzvideo, Kamera, Action-/NLA-Konventionen. - Erste echte Clips (Vorwärtsgleiten, Rückwärts, Pirouette). - Android: Texturen auf 1K reduzieren oder separater Asset-Pack. - Workbench-Backup außerhalb des Repos sicherstellen.