CR 23: Asset-Grundausstattung importiert und Pipeline verifiziert

Fuenf CC0-Packs von Quaternius entpackt, sortiert und in Godot importiert.
Alle fuenf License_Standard.txt bestaetigen CC0 1.0 — CREDITS.md fuehrt sie
mit Quelle, Lizenz und Zielordner.

296 Modelle als glTF unter assets/models/: characters/basis (2) und
characters/haare (8), characters/animations (2 glb mit 43 Animationen, mit
und ohne Root Motion), outfits/komplett (4) und outfits/teile (20), props
(94, thematisch sortiert), environment (166, nach Bauteil-Art). Zehn
redundante Dach-Groessenvarianten blieben draussen; 4x4, 6x6 und 8x8 stehen
stellvertretend.

tools/import_quaternius.py macht den Vorgang reproduzierbar: es entpackt
selektiv die glTF-Zweige, bringt Dateinamen auf snake_case und schreibt
dabei die relativen URIs in den .gltf-Dateien mit — ohne das waeren Buffer-
und Texturverweise nach dem Umbenennen tot. Texturen liegen einmal pro Pack
unter <pack>/textures/. Zwei kaputte Verweise im Quell-Pack korrigiert:
T_Hair_1_Normal_png.png und T_Eye_Normal_png.png existieren bei Quaternius
nicht, dort fehlt das _png.

Der eigentliche Punkt ist die Rig-Kompatibilitaet: Basis-Charaktere, Outfits
und Animationsbibliothek liefern dasselbe 65-Knochen-Skelett im
Unreal-Namensschema, Knochenliste identisch. scenes/test/asset_pipeline_test
legt darum Koerper, Ranger-Outfit und Frisur auf das Skelett der Animation
Library — 13 Meshes auf 65 Knochen — und spielt elf Schau-Animationen ab.

Keine bestehende Szene angefasst: der Primitiven-Austausch ist laut CR 23
ausdruecklich ein eigener Folge-Schritt und steht jetzt als CR 24 in
CHANGEREQUESTS.md, zusammen mit dem noetigen Trimmen der Basis-Koerper und
der offenen Entscheidung ueber die 4K-Outfit-Texturen.

Verifiziert mit dev_cr23_probe (25/25) und einem Boot-Check ueber zwoelf
Szenen — Hof, Sparringshalle, Aula, Schlafsaal, Gauntlet, Viadukt und
Kampf-Testground alle unveraendert lauffaehig. Sonden vor dem Commit
geloescht.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-21 18:00:57 +02:00
parent adf9fb706f
commit b911f243be
1021 changed files with 152674 additions and 73 deletions

View file

@ -3,6 +3,79 @@
> Abgearbeitete Change Requests aus CHANGEREQUESTS.md, mit Datum und
> Anmerkung, was geändert wurde.
## 2026-07-21 — CR 23: Asset-Import-Grundausstattung (Quaternius, CC0)
**Request:** CHANGEREQUESTS §23 — fünf CC0-Quaternius-Packs aus
`assets/_staging/` entpacken, sortiert nach `assets/models/` einordnen
(snake_case), in Godot importieren und die Rig-Kompatibilität an einer
Testfigur verifizieren. Ausdrücklich **kein** Szenen-Umbau.
**Lizenz-Prüfung:** Alle fünf `License_Standard.txt` bestätigen **CC0 1.0
Universal**. Keine Unklarheit, keine Rückfrage nötig. CREDITS.md führt
jetzt alle fünf Packs mit Quelle, Lizenz und Zielordner.
**Intake:** `tools/import_quaternius.py` (aufbewahrt, damit der Vorgang
reproduzierbar bleibt — etwa beim späteren Nachziehen der PRO-Variante)
entpackt selektiv nur die glTF-Zweige, bringt alle Dateinamen auf
snake_case und **schreibt dabei die relativen URIs in den `.gltf`-Dateien
mit** — ohne das wären Buffer- und Textur-Verweise nach dem Umbenennen
tot. Texturen liegen einmal pro Pack unter `<pack>/textures/`, die
Modelle referenzieren sie relativ; keine Duplikate über die Themenordner.
**Zwei kaputte Verweise im Quell-Pack repariert:** Die Basis-Charaktere
referenzierten `T_Hair_1_Normal_png.png` und `T_Eye_Normal_png.png` —
beide existieren bei Quaternius nicht, dort fehlt das `_png`. Der Import
zeigt jetzt auf die tatsächlich vorhandenen Dateien.
**Sortierung** (296 Modelle, glTF wie in ASSETS.md gefordert):
`characters/basis` (2) + `characters/haare` (8) + `characters/animations`
(2 glb mit 43 Animationen, mit und ohne Root Motion), `outfits/komplett`
(4) + `outfits/teile` (20), `props/` (94, thematisch in Möbel, Bücher,
Behälter, Licht, Küche, Waffen), `environment/` (166 in Wände, Türen,
Fenster, Böden, Dächer, Treppen, Balkone, Ecken, Vorsprünge, Bauteile).
Von den Umgebungsteilen wurden **10 redundante Dach-Größenvarianten**
weggelassen (4x4, 6x6 und 8x8 bleiben als Stellvertreter) — der Rest der
Matrix wäre nur Ballast im Browser. `assets/_staging/` enthält wieder nur
`.gitkeep`; die ZIPs sind gelöscht und waren ohnehin gitignored.
**Rig-Kompatibilität (der eigentliche Punkt):** Alle drei Charakter-Packs
liefern **dasselbe 65-Knochen-Skelett** im Unreal-Namensschema
(`root, pelvis, spine_01 … Head, clavicle_l`) — Knochenliste identisch,
nicht nur gleich lang. Deshalb lassen sich Körper, Kleidung und Animation
auf ein Skelett legen.
**Testszene** `scenes/test/asset_pipeline_test.tscn`: Die Animation
Library stellt Skelett und AnimationPlayer (ihr Mannequin wird
ausgeblendet), Basis-Charakter, Ranger-Outfit und Frisur werden auf
dieses Skelett umgehängt — 13 Meshes auf 65 Knochen. `interact` blättert
durch elf Schau-Animationen. Ein gerenderter Durchlauf zeigt die
bekleidete Figur, die die Animation sauber abspielt.
**Bekannte Kosmetik, kein Pipeline-Fehler:** Der Basis-Charakter ist EIN
Mesh aus Kopf und Körper. Bleibt er sichtbar, stößt der Körper an
bedeckten Stellen durch die Kleidung; blendet man ihn aus
(`is_base_body_visible = false`), sitzt das Outfit sauber, aber das
Gesicht fehlt. Quaternius' Readme nennt den Weg: verdeckte Körperteile in
Blender entfernen. Das gehört in den Austausch-Schritt (jetzt CR 24),
nicht in diese Verifikation — beide Zustände sind in der Testszene per
Schalter vergleichbar.
**Verifikation:** Sonde `dev_cr23_probe` 25/25 — snake_case über alle
Asset-Dateien, Ablage und Stückzahlen je Ordner, leeres Staging,
Import als PackedScene, Skeleton3D, Materialien und verdrahtete Normal
Maps, identische Knochenlisten der drei Packs, Aufbau der Testfigur,
ausgeblendetes Mannequin, geskinnte Meshes, sitzendes Outfit, laufende
Animation aus der Library, und dass die Animation die Knochenpose
tatsächlich verändert. Zusätzlich Boot-Check über zwölf Szenen —
darunter Hof, Sparringshalle, Aula, Schlafsaal, Gauntlet, Viadukt und
Kampf-Testground: **alle unverändert lauffähig**, es wurde keine
bestehende Szene angefasst. Sonden vor dem Commit gelöscht.
**Offen gelassen (jetzt CR 24):** der eigentliche Primitiven-Austausch,
das Trimmen der Basis-Körper und die Entscheidung über die 4K-Texturen
der Outfits (~229 MB Assets insgesamt; ASSETS.md hält fest, dass mehr
Auflösung bei diesen flächigen Charakter-Texturen nichts bringt).
## 2026-07-20 — CR 13: Minispiele mit Einsatz (Poker + Messerspiel)
**Request:** CHANGEREQUESTS §13 (Welle 3) — diegetische Minispiele mit