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

@ -6,6 +6,175 @@
---
# Neue Change Requests aus dem Akt-1-Testdurchlauf (2026-07-21)
> Findings des Autors beim Durchspielen von v1. **Priorität vor den Akt-2-CRs
> weiter unten** — das ist Politur am fertigen v1-Umfang.
## 17. Poker mit echten Karten + Figuren am Tisch
> Delta gegen die CR-13-Umsetzung: Poker läuft aktuell rein über Menü-Optionen
> und fühlt sich dadurch nicht wie Poker an; die Gegner sind abstrakt statt
> anwesend.
- **Echte Karten als UI-Overlay** (entschieden): klassische Poker-Ansicht mit
sichtbaren Karten und echten Setzrunden statt reiner Text-Optionen. **Kein**
3D-Kartenmodell.
- **Die Karten-Grafiken liefert der Autor** als PNGs unter `assets/ui/cards/`
(daten-getrieben referenzieren). **Greybox-First:** Bis die PNGs da sind, muss
das Spiel mit einfachen Platzhalter-Karten (Rechteck + Wert/Farbe als Text)
vollständig spielbar sein — der Bau wartet NICHT auf die Assets.
- **Figuren laufen an und setzen sich:** Wählt man einen Gegner, kommt die Figur
sichtbar zum Spieltisch der Aula gelaufen und nimmt Platz.
- **Dealer-Rollenlogik:**
- Gegner = **Imogen** (oder andere Figur) → **Ridoc übernimmt den Dealer**.
- Gegner = **Ridoc** → er dealt **selbst** und spielt zugleich.
- **Akzeptanz:** Poker wird mit sichtbaren Karten über echte Setzrunden gespielt;
der gewählte Gegner läuft an und sitzt am Tisch; die Dealer-Rolle ist nach obiger
Regel besetzt; mit Platzhalter-Karten voll spielbar, mit den PNGs identisch, nur
hübscher.
- **Betrifft:** `game_table.gd`, `data/minigames/table_games.json`, Aula-Szene.
- **Annahme (bitte widersprechen, falls falsch):** Das Anlaufen/Hinsetzen gilt für
den Spieltisch generell, also auch fürs **Messerspiel**.
## 18. Das Vierte Geschwader muss existieren — Ridoc, Sawyer, Liam, Dain
> **Befund:** In `data/dialogue/` gibt es KEINE Datei für Ridoc, Sawyer, Liam oder
> Dain — die halbe Staffel ist stumm, obwohl SPEC §4 sie als Tyrveils Alltag setzt
> und CR 5 ihn in genau diese Staffel gestellt hat.
- **Ridoc zuerst** (ausdrücklich gewünscht): eigener sprechender NPC mit seiner
typischen Art — der Humor der Truppe (humans/RIDOC.md). Er ist auch der Dealer
aus CR 17.
- Ebenso als sprechende Figuren im Alltag: **Sawyer** (ruhig, Bodenhaftung),
**Liam** (strahlend, loyal, Tyrveils engster Freund unter den Erstjahren — bleibt
in v1 lebendig), **Dain** (Staffelführer, Regeltreue, natürliche Reibung).
- Die Staffel soll als **Gruppe spürbar** sein: gemeinsame Auftritte in Aula/Hof,
Staffel-Beats, Reaktionen aufeinander — nicht nur Namen in einer Liste.
- **Akzeptanz:** Jede der vier Figuren hat mindestens einen eigenen Dialogbaum in
ihrer dokumentierten Stimme und ist im Hub antreffbar; Ridoc hat zusätzlich seine
Rolle am Spieltisch; mindestens eine Szene zeigt die Staffel als Gruppe.
- **Stimmen-Quellen:** humans/RIDOC.md, SAWYER.md, LIAM.md, DAIN.md +
CHARACTERS.md. **Kanon-Zeitfilter beachten** (WELT.md §9) — nichts aus Buch 2/3.
## 19. Stimmen-Schreibpass — Dialoge klingen „geschrieben", nicht gesprochen
> Autor: Violet klingt nicht wie Violet, Imogen ist gegenüber Tyrveil zu
> abgedroschen, **Xaden ist am schlimmsten**.
>
> **Ursachen-Befund (wichtiger als die Einzelzeilen):** Die Dialoge geben die
> *Beschreibungen* aus den Figuren-Akten wieder, statt sie zu spielen. Wo die Akte
> sagt „Tyrveil kennt Xadens Geheimnisse", sagt die Zeile wörtlich „Du kennst meine
> Geheimnisse". Die Charakter-Bibel ist in den Mund der Figuren gewandert.
**Die sechs Anti-Muster** (alle belegt in `xaden_intro.json` und
`cassian_ambush_choice.json`):
1. **Selbst-narrierte Gefühle** — „…und erst mal eine Wand angestarrt", „dass ich
gerade fast gelächelt habe". Die Figur erzählt ihren Gefühlszustand, statt ihn
zu zeigen. Verstößt frontal gegen Xadens „nie sentimental" (CHARACTERS.md).
2. **Die Zeile erklärt ihre eigene Pointe** — „Du weißt, wie ich das meine.",
„…du weißt inzwischen, wie der Satz endet." Erst landet der Satz, dann erklärt
die Figur, dass er gelandet ist. Tötet den Subtext.
3. **Rhetorische Symmetrie / Monolog-Rhythmus** — „Ein Jahr, Tyr. Ein Jahr mehr
hätte ich…", „Gut, dass du da bist. Nicht gut, DASS du da bist." Anapher und
Antithese sind Bühnensprache. Xaden soll **halbe Sätze** sprechen, „die der
andere zu Ende denkt".
4. **Beziehungs-Exposition** — „Du kennst meine Wege, du kennst meine Geheimnisse".
Zwei Männer, die wie Brüder aufwuchsen, rezitieren einander nicht ihre
Beziehung. Das ist Exposition für den Spieler im Mund der Figur.
5. **Das Thema laut aussprechen** — Tyrveils „Ich bin nicht das Wetter, Cassian."
Die Metapher des Gegners aufgreifen und widerlegen ist Debattierklub, kein
Gespräch. TYRVEIL.md verlangt „lieber ein knapper Satz mit Doppelboden als drei
erklärende".
6. **Meta-Callback** — Cassian behandelt sein eigenes Motiv als bekannten Spruch
(„du weißt inzwischen, wie der Satz endet"). Das zwinkert dem Spieler zu und
bricht die Figur.
- **Auftrag:** Alle Dialogbäume in `data/dialogue/` gegen diese sechs Muster
durchgehen und neu schreiben — **Xaden zuerst und am gründlichsten**, dann Violet
und Imogen. Stimmen-Quellen: die Akten in `humans/` + CHARACTERS.md.
- **Faustregeln:** Kürzen ist fast immer die Lösung. Was eine Figur fühlt, gehört in
**das, was sie tut oder verschweigt** — nicht in ihre Zeile. Was beide wissen,
sagt keiner laut. Pointen bleiben unkommentiert stehen.
- **Akzeptanz:** Keine Zeile im Bestand erfüllt noch eines der sechs Muster; Xadens
Auftritte kommen mit hörbar weniger Worten aus; ein Blindtest „wer spricht hier?"
ist bei Xaden/Violet/Imogen/Ridoc/Tyrveil eindeutig beantwortbar.
- **Wichtig:** Reiner Schreibpass — **keine** Story-Fakten, Flags, Effekte oder
Verzweigungen ändern (Ton ≠ Ausgang, STORY §6).
## 20. Viadukt-Respawn wirft in den Schlafsaal (CR-16-Regression)
> **Bug, Ursache gefunden.**
- **Symptom:** Fällt man vom Viadukt, spawnt man im **Schlafsaal** statt am Viadukt.
- **Ursache:** `viaduct.gd:114` ruft `SaveSystem.reload_last_save()` — man landet
am letzten Speicherpunkt. Die Checkpoint-Logik existiert noch
(`_checkpoint_position`, Zeilen 49/105), wird aber **nie zum Respawn benutzt**.
Eingeschleppt mit CR 16. Der **Gauntlet macht es korrekt**
(`gauntlet.gd:384` respawnt am Checkpoint) — zwei gleichartige Set-Pieces, zwei
Verhalten.
- **Einheitliche Todes-Regel (entschieden 2026-07-21):**
- **Set-Pieces mit Checkpoints — Viadukt und Gauntlet — respawnen am letzten
Checkpoint** innerhalb des Laufs.
- `reload_last_save()` bleibt **nur** für die Story-Tode: Tag-9-Hinterhalt
(`cassian_ambush.gd`) und Dreschen-Prüfung (`hatching_grounds.gd`).
- **Akzeptanz:** Sturz am Viadukt setzt den Spieler am zuletzt erreichten
Viadukt-Checkpoint ab (bzw. am Anfang des Laufs, wenn noch keiner erreicht wurde);
kein Szenenwechsel, kein Laden; Gauntlet-Verhalten unverändert; SPEC §6
(„Speichersystem") um die Checkpoint-Ausnahme ergänzen.
## 21. „Blätter jagen": echte Hatz statt driftendes Pickup
> Delta gegen die CR-12-Umsetzung. Vorbild: die Sea-Shanty-Seiten aus AC4
> Black Flag.
- **Befund:** `loose_page.gd` lässt jedes Blatt in *einer zufälligen, konstanten
Richtung* treiben und am Kreisrand umspringen — es **reagiert nicht auf den
Spieler**. Dadurch ist es ein bewegtes Pickup, keine Jagd.
- **Soll:** Das Blatt **reagiert auf die Annäherung** — kommt der Spieler nah,
reißt eine Böe es weg, es wirbelt hoch, wechselt die Richtung. Der Reiz ist die
Hatz mit Beinahe-Griffen.
- **Harte Balancing-Regel (Autor):** Es muss **trotzdem erreichbar bleiben**. Die
Flucht darf das Blatt nicht unfangbar machen — z. B. nachlassende Böen,
Abklingzeit zwischen Ausweichern, Sacken nach einer Flucht, oder ein Fenster, in
dem Slide/Sprint/Sprung sicher zugreifen. **Jede Jagd endet einholbar.**
- **Akzeptanz:** Ein Blatt weicht bei Annäherung spürbar aus (nicht nur konstantes
Driften); mehrere Beinahe-Griffe pro Jagd sind normal; **keine Jagd ist
unabschließbar** — mit dem bestehenden Movement ist jedes Blatt sicher fangbar;
Fund-Typen und Belohnungen aus CR 12 bleiben unverändert.
- **Betrifft:** `loose_page.gd` (Flugverhalten), ggf. `page_spawner.gd`.
## 24. Primitiven-Austausch in den echten Szenen (Folge-Schritt aus CR 23)
> Aufgemacht am 2026-07-21, nachdem CR 23 die Pipeline verifiziert hat. Die
> Assets liegen sortiert und importiert unter `assets/models/`, die
> Rig-Kompatibilität ist bewiesen — jetzt geht es an die Szenen selbst.
- **Umfang:** Kapsel-/Box-Primitiven in Hof, Sparringshalle, Aula, Schlafsaal,
Lehrträumen usw. durch die importierten Modelle ersetzen. Szene für Szene,
nicht alles auf einmal.
- **Charaktere zuerst vorbereiten:** Der Basis-Charakter ist EIN Mesh aus Kopf
und Körper; unter Kleidung stößt der Körper durch. Quaternius' Readme nennt
den Weg — verdeckte Körperteile in Blender entfernen, nur der Kopf wird
gebraucht (spart zusätzlich Rechenzeit). Das ist die Voraussetzung für
saubere bekleidete NPCs.
- **Animationen anbinden:** Die Universal Animation Library deckt die
CR-8-Kampfgrammatik ab (`Sword_Idle`, `Sword_Attack`, `Roll`, `Punch_Cross`,
`Hit_Chest`, `Death01`) sowie Bewegung (`Idle`, `Walk`, `Jog_Fwd`, `Sprint`)
und Sozialbeats (`Sitting_Idle`, `Idle_Talking`). Root-Motion-Variante `_rm`
liegt bereit, falls sie gebraucht wird.
- **Offen zu entscheiden:** Die Outfit-Texturen liegen in 4K (~84 MB allein für
`assets/models/outfits/textures/`, insgesamt ~229 MB). ASSETS.md hält fest,
dass mehr Auflösung bei diesen flächigen Charakter-Texturen nichts bringt —
ein Herunterrechnen auf 1K/2K wäre also verlustfrei fürs Bild und spürbar
fürs Repo. Bewusst nicht in CR 23 entschieden.
## 22. Journal/Lexicon-Texte überarbeiten
> „Das Journal ist noch cringe geschrieben."
- Die Texte im Lexicon (Fach-Seiten, Personen & Gerüchte, Codex-Einträge, Kalender-
und Abschlusszeilen) gegen dieselben Anti-Muster wie CR 19 prüfen — vor allem
Muster 1 (selbst-narrierte Gefühle) und 2 (die Zeile erklärt ihre Pointe).
- **Ton-Setzung:** Das Lexicon ist **Tyrveils Buch** — es darf seine Stimme haben
(trocken, untertrieben, Galgenhumor; TYRVEIL.md), statt neutral-erklärend oder
pathetisch zu sein.
- **Akzeptanz:** Kein Eintrag erklärt dem Spieler seine eigene Bedeutung; die
Einträge sind hörbar aus Tyrveils Perspektive geschrieben; Fakten und
Freischalt-Logik bleiben unverändert.
- **Betrifft:** `data/lexicon/subjects.json`, `data/story/codex.json`, die
Kalender-/Seitentexte in `scripts/ui/lexicon.gd`.
- **Kann als ein Schreibpass zusammen mit CR 19 laufen.**
---
# Neue Change Requests aus der Autoren-Sitzung (Story/Welt-Ausbau)
> **Nur noch offene Punkte** — abgeglichen mit CHANGEREQUESTS_DONE.md. Der
@ -15,50 +184,15 @@
> Vor der Umsetzung lesen: SPEC.md (§3, §5.1, §6), STORY.md (§3, §5, §6),
> dragons/SMÀLADH.md, WELT.md. Greybox-First, alles daten-getrieben.
## 8. Kampfsystem-Überarbeitung — Action-RPG (GROSS, mehrphasig)
> Kaddis-Runde 2. **Grundsatz-Entscheidung des Autors:** Action wird ein **großer
> Kern-Pfeiler** (SPEC §1). Das bestehende Sparring (nur Schlagen/Blocken,
> statisch, `sparring_fight.gd`) wird **ersetzt**.
>
> **Design-Entscheidungen gesetzt (2026-07-19):**
> - **Reichweite = Encounter-Zonen, KEIN Welt-Sandbox** (Option B): Kampf nur in
> definierten Szenen/Zonen (Sparring, Tag-9-Hinterhalt, bewusst gesetzte
> Encounter). Der Hub bleibt sozialer Raum — **keine roamenden Gegner** auf dem Hof.
> - **Grammatik:** leichter Angriff, schwerer Angriff, **Ausweichen** (schneller
> Seitenschritt, Positionierung, **KEINE** i-Frames), **Dodgen** (Rolle **mit**
> Unverwundbarkeits-Fenster, Ausdauer-Kosten), **Magie** (nur nach der Bindung,
> Akt 2+ — s. Zeitschiene), **Kombos**.
> - **Waffen jederzeit wechselbar**; Waffenskill **pro Waffenart getrennt**
> (Dolch/Schwert/Axt unabhängig geskillt). **Skill hebt NICHT den Rohschaden**,
> sondern schaltet Kombos/Optionen frei und senkt Ausdauerkosten / weitet Fenster
> → „**gleiche DPR bei gleichem Skill**" bleibt gewahrt.
> - **Permadeath entfällt** → eigenes Speicher-/Camp-System, **CR 16**. Sterben =
> letzter Spielstand statt Game Over.
>
> **Zeitschiene v1 ↔ Akt 2:** In **v1** (vor dem Dreschen) hat Tyrveil **keinen
> Drachen → keine Magie**; der Kampf ist rein **Nahkampf** (Sparring, Tag-9). Die
> **Magie-Ebene** (Siegelkraft/Lesser Magic im Kampf) gehört zu **Akt 2+** (nach
> Smàladh; verzahnt mit CR 9).
- **Stats-Kopplung (RPG-Kern bleibt):** Kraft→Schaden, Schnelligkeit→Angriffs-/
Ausweich-/Dodge-Tempo & Block-/Konterfenster, Verstand→Gegner-Lesen/Konter-Hilfen.
**Skill UND Werte zählen.**
- **Waffensystem:** Dolche (schnell, kurze Reichweite), Schwerter (Mitte), Äxte
(langsam, weit/wuchtig). **Gleiche DPR** über alle Klassen — Wahl = Stil.
- **Rüstungen:** Trade-off **Schutz ↔ Tempo** (kein „mehr = besser").
- **Betroffen:** Sparring (Phase-4-System, ersetzt), Tag-9-Hinterhalt (QTE →
echter Kampf), Movement (Viadukt/Gauntlet bleiben Geschicklichkeit), neue
Input-Actions (SPEC §9 erweitern: heavy_attack, dodge, weapon_switch, später
cast). Greybox-First, daten-getrieben.
### Sub-CRs (Reihenfolge = Bau-Track)
- **8a — Kampf-Kern** ✅ erledigt (2026-07-19, siehe CHANGEREQUESTS_DONE).
- **8b — Waffen-Framework** ✅ erledigt (2026-07-19, siehe CHANGEREQUESTS_DONE).
- **8c — Kombo- & Waffenskill-System** ✅ erledigt (2026-07-19, siehe CHANGEREQUESTS_DONE).
- **8d — Encounter-Umbau** ✅ erledigt (2026-07-19, siehe CHANGEREQUESTS_DONE).
- **8e — Rüstungen + Balancing** ✅ erledigt (2026-07-19, siehe CHANGEREQUESTS_DONE).
- **8-magie (Akt 2+, NACH dem Dreschen):** Magie-Ebene der Grammatik (Siegelkraft/
Lesser Magic im Kampf), verzahnt mit CR 9. **Nicht in v1.**
## 8-magie. Magie-Ebene des Kampfsystems (ab Akt 2)
> Rest von CR 8 — die Sub-CRs 8a–8e sind gebaut (2026-07-19, siehe
> CHANGEREQUESTS_DONE). Das fertige Kampfsystem und seine dauerhaften Regeln
> (Encounter-Zonen, gleiche DPR, Waffenskill-Regel) stehen jetzt in **SPEC §6,
> „Kampfsystem"**.
- Die **Magie-Ebene** der Kampf-Grammatik (Siegelkraft / Lesser Magic im Kampf) —
existiert erst **nach der Bindung**, verzahnt mit CR 9 (Bindungs-Achse).
- **Nicht in v1**: vor dem Dreschen hat Tyrveil keinen Drachen und damit keine
kanalisierbare Magie.
## 9. Drachen-Bindung als dritte Dialog-Achse (ab Akt 2)
> Kaddis-Runde 2.
@ -96,17 +230,21 @@
---
## Phasen-Plan (Reihenfolge für den Entwickler-Claude)
> _Status (2026-07-19, Claude): **Welle 1 ist komplett abgearbeitet** —
> CR 16 (Speichersystem), CR 6 (Zweitsignet latent), CR 5 (Staffel-Setup)
> und CR 14+15 (Aula + Hub-Layout) sind erledigt, siehe
> CHANGEREQUESTS_DONE. Damit sind auch die Phasen 7–11 und CR 1–7 durch._
> _Status (2026-07-20, Claude): **Wellen 1–3 sind komplett abgearbeitet.**
> Welle 1 (CR 16 Speichersystem, CR 6 Zweitsignet latent, CR 5 Staffel-Setup,
> CR 14+15 Aula + Hub-Layout), Welle 2 (CR 8a–8e — Kampfsystem komplett) und
> Welle 3 (CR 11 Gefechtskunde-Karte, CR 12 Blätter jagen, CR 13 Minispiele)
> sind erledigt, siehe CHANGEREQUESTS_DONE. Damit sind auch die Phasen 7–11
> und CR 1–7 durch. **Der v1-Umfang ist damit inhaltlich beisammen.**_
>
> _Offen (Reihenfolge nach ROADMAP.md):_
> - _**Welle 2: CR 8 (Kampfsystem-Action-RPG)** — das große Programm in den
> Sub-CRs 8a→8e; berührt Sparring und den Tag-9-Hinterhalt._
> - _Welle 3 (Flavor auf fertigen Systemen): CR 11 (Gefechtskunde-Karte),
> CR 12 (Blätter jagen), CR 13 (Minispiele — die Aula-Ecke steht jetzt)._
> - _Welle 4 (Akt 2, jenseits v1): CR 9 (Bindungs-Achse), CR 10
> (Drachenpflege), CR 8-magie, CR-16-Rest (Camp im Feld)._
> _Offen — nur noch **Welle 4 (Akt 2, jenseits v1)** und ein Stretch:_
> - _CR 9 (Bindungs-Achse), CR 10 (Drachenpflege), CR 8-magie (Magie im Kampf),
> CR-16-Rest (Camp im Feld) — alle setzen die Bindung an Smàladh voraus und
> greifen erst **nach** dem Dreschen/ersten Flug._
> - _CR 13-Rest: eigenes Kartenspiel (Stretch, kein v1-Ziel)._
>
> _Nächster inhaltlicher Schritt ist NICHT Code, sondern Story: **Akt 2 ist in
> STORY.md §9 ausdrücklich „noch auszuarbeiten"** — ohne ihn hängen CR 9/10/
> 8-magie in der Luft._
>
> _Vollständige, gewichtete Reihenfolge in Wellen: **ROADMAP.md**._