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

@ -4,6 +4,23 @@
> Blocker. Das Spiel läuft komplett mit Primitiven, bevor hier irgendwas
> importiert wird.
## Look-Entscheidung: stilisiert/low-poly bleibt (bestätigt 2026-07-21)
Ein realistischer PBR-Charakter-Weg wurde geprüft (CGTrader-Realistic-Bodies:
30k Polys, "Royalty Free"-Lizenz statt CC0, keine Kleidung, unklare
Animations-Abdeckung, kein glTF; freier Test-Drache: **Editorial License —
ungeeignet fürs Produkt**) und als zu aufwendig/riskant für Solo + kein Budget +
keine 3D-Vorerfahrung verworfen. **SPEC §2 „stilisiert/low-poly" bleibt gültig.**
„HD" heißt in diesem Rahmen NICHT höhere Textur-Auflösung bei Charakteren
(KayKit/Quaternius-Texturen sind bewusst einfache Flächen ohne Detail — mehr
Auflösung bringt dort nichts), sondern:
- **Umgebung ist bereits „HD"**: Poly Haven/ambientCG liefern bis 8K-PBR-Sets auch
auf einfacher Low-Poly-Geometrie.
- **Der eigentliche Polish-Hebel für Charaktere/Räume ist Beleuchtung &
Post-Processing**, nicht Texturauflösung: Kantenglättung (MSAA), Ambient
Occlusion, weiches Rim-Licht, Bloom, Farbgrading. Das ist der Weg zu „wirkt
hochwertig", ohne die Low-Poly-Entscheidung zu verlassen.
## Lizenz-Kurzregel
- **CC0** — mach was du willst, keine Namensnennung nötig. Bevorzugt.
- **CC-BY** — frei nutzbar, aber Credit in `CREDITS.md` pflegen.
@ -39,8 +56,15 @@
Button-Prompts (Ⓐ / ✕ je erkanntem Controller).
## Texturen, Himmel, Materialien
- **Poly Haven** — CC0 Texturen, HDRIs, teils 3D-Modelle.
- **ambientCG** — 1500+ CC0-PBR-Materialien.
- **Poly Haven** — CC0 Texturen, HDRIs, teils 3D-Modelle. Auflösung bis 8K,
**Hauptquelle**.
- **ambientCG** — 1500+ CC0-PBR-Materialien, bis 8K. **Hauptquelle.**
- **Poliigon** (auf Empfehlung geprüft, 2026-07-21) — NUR als Ergänzung: frei sind
ca. 100 Assets (Rest kostenpflichtig, Credit-System). Format ist unproblematisch
(PNG/JPG/TIFF/EXR, trotz "made for Blender/Max/Maya/C4D"-Werbetext — das sind
gewöhnliche PBR-Bilddateien, kein Engine-Lock-in). **Godot-Import-Hinweis:**
Normal Maps ggf. mit "Normal Map Invert Y" importieren (OpenGL- vs.
DirectX-Konvention) — gilt für Fremd-Texturen generell, nicht Poliigon-spezifisch.
## Audio (optional, später)
- **Freesound.org** — Filter CC0 für strings-free Nutzung.

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**._

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

View file

@ -5,10 +5,12 @@
> stehen weiter in CHANGEREQUESTS.md, der Kanon in SPEC > STORY > WELT. Erledigte
> CRs wandern nach CHANGEREQUESTS_DONE.md; dann hier den Status nachziehen.
>
> Stand: **2026-07-20**. Erledigt: Phasen 0–11, CR 1–8 (8a–8e), CR 11, CR 12,
> CR 13, CR 14, CR 15, CR 16 — **Wellen 1, 2 und 3 komplett**. Offen: das
> eigene Kartenspiel (Stretch aus CR 13) und
> CR 9/10/8-magie/CR-16-Camp (Welle 4, Akt 2).
> Stand: **2026-07-21**. Erledigt: Phasen 0–11, CR 1–8 (8a–8e), CR 11–16,
> CR 23 (Asset-Pipeline steht und ist verifiziert) — **Wellen 0–3 komplett**,
> v1 steht inhaltlich. Offen: die **Politur-Welle
> CR 17–22** (Findings aus dem Akt-1-Testdurchlauf, Priorität), der
> Primitiven-Austausch **CR 24** (Folge-Schritt aus CR 23), danach Welle 4
> (Akt 2: CR 9/10/8-magie/CR-16-Camp) und das eigene Kartenspiel (Stretch).
## Leitprinzip der Reihenfolge
Erst **Entscheidungs-Blocker räumen** (billig, schaltet Ketten frei), dann
@ -16,11 +18,18 @@ Erst **Entscheidungs-Blocker räumen** (billig, schaltet Ketten frei), dann
Kampf-Track** (höchstes Risiko, berührt viele v1-Systeme), dann **Flavor/Content**
auf fertigen Systemen, zuletzt die **Akt-2-Features** (jenseits v1).
## Kritischer Pfad (ein Satz)
**Kleine Fixes (CR 6-Umsetzung, CR 5, CR 16, CR 14+15) parallel → CR 8-Bau
(8a→8e) → Flavor (CR 11/12/13) → Akt 2 (CR 9/10 + CR 8-magie).**
_CR 8 ist bereits in Sub-CRs geschärft (Welle 0 erledigt) — kein Entscheidungs-
Blocker mehr offen._
## Kritischer Pfad
Der ursprüngliche Bau-Pfad (kleine Fixes → CR-8-Bau → Flavor) ist **vollständig
durchlaufen**; v1 steht inhaltlich.
**Jetzt: Politur-Welle** (CR 17–22 aus dem Akt-1-Testdurchlauf) — v1 rundschleifen,
bevor Akt 2 aufgemacht wird.
**Danach ist der Engpass kein Code, sondern Story:** **Akt 2 ist in STORY.md §9
ausdrücklich „noch auszuarbeiten"**. CR 9 (Bindungs-Achse), CR 10 (Drachenpflege)
und CR 8-magie hängen alle daran — ohne ausgearbeiteten Akt 2 lässt sich ihr Inhalt
nicht sinnvoll spezifizieren. **Welle 4 beginnt also mit Autoren-Arbeit**, nicht
mit Umsetzung.
---
@ -54,13 +63,14 @@ Reine Doc-/Design-Arbeit, kein Code. Beide Blocker sind geräumt:
CR 8d ohnehin Tag-9 anfasst.
## Welle 2 — Der große Kampf-Track — ✅ erledigt (2026-07-19)
- **CR 8 — Action-RPG-Kampf-Umbau** nach den Sub-CRs **8a→8b→8c→8d→8e** (voller
Spec: CHANGEREQUESTS §8). Reichweite = **Encounter-Zonen** (Option B), kein
- **CR 8 — Action-RPG-Kampf-Umbau** nach den Sub-CRs **8a→8b→8c→8d→8e**. Die
dauerhaften Regeln des fertigen Systems stehen jetzt in **SPEC §6,
„Kampfsystem"**. Reichweite = **Encounter-Zonen** (Option B), kein
Welt-Sandbox. Berührt Sparring (ersetzt), Tag-9-Hinterhalt (QTE → echter Kampf),
Movement-Abgrenzung (Viadukt/Gauntlet bleiben Geschicklichkeit). Greybox-First;
gleiche DPR über alle Waffenklassen. **Magie-Kampf (8-magie) erst Akt 2.**
## Welle 3 — Flavor/Content auf fertigen Systemen
## Welle 3 — Flavor/Content auf fertigen Systemen — ✅ erledigt (2026-07-20)
Setzen auf bereits erledigte Systeme auf (CR 8 nicht nötig).
- ~~**CR 11 — Gefechtskunde-Karte (Devera).**~~ **ERLEDIGT (2026-07-20).**
Klick-Karte mit animierten Truppenbewegungen als `map_question`-Beat im
@ -76,6 +86,21 @@ Setzen auf bereits erledigte Systeme auf (CR 8 nicht nötig).
**eigene Kartenspiel** war im CR als Stretch markiert und bleibt offen — es
steht als verschlanktes CR 13 in CHANGEREQUESTS.md.
## Politur-Welle — v1-Feinschliff (aus dem Akt-1-Testdurchlauf, 2026-07-21)
**Priorität vor Welle 4.** Findings des Autors am fertigen v1-Umfang. Gut
parallelisierbar; zwei davon sind reine Schreibarbeit.
- **CR 20 — Viadukt-Respawn-Fix** (Bug, CR-16-Regression). Klein und isoliert,
**zuerst** — Sturz wirft aktuell in den Schlafsaal statt an den Checkpoint.
- **CR 18 — Viertes Geschwader existiert** (Ridoc, Sawyer, Liam, Dain sprechen).
Content; Ridoc zuerst, weil CR 17 ihn als Dealer braucht.
- **CR 17 — Poker mit echten Karten + Figuren am Tisch.** UI-Overlay; Karten-PNGs
liefert der Autor, Platzhalter-Karten dürfen den Bau nicht blockieren.
- **CR 21 — Blätter-Jagd auf Black-Flag-Gefühl.** Blatt reagiert auf Annäherung,
bleibt aber garantiert einholbar.
- **CR 19 + CR 22 — Schreibpass** (Dialoge + Journal/Lexicon) gegen die sechs
Anti-Muster. Können als **ein** Durchgang laufen; Xaden zuerst.
## Welle 4 — Akt 2 (jenseits v1)
Greifen erst nach Dreschen + erstem Flug; brauchen die CR-6-Basis.
- **CR 9 — Bindung als dritte Dialog-Achse** (verdeckter Smàladh-Wert 0–100 →
@ -98,9 +123,18 @@ Greifen erst nach Dreschen + erstem Flug; brauchen die CR-6-Basis.
| 8-magie | Magie-Kampf | 4 (Akt 2) | offen |
| 9 | Bindungs-Achse (Akt 2) | 4 | offen |
| 10 | Drachenpflege (Akt 2) | 4 | offen |
| 11 | Gefechtskunde-Karte | 3 | offen |
| 12 | Blätter jagen | 3 | offen |
| 13 | Minispiele | 3 (nach CR 14) | offen |
| 11 | Gefechtskunde-Karte | 3 | erledigt (2026-07-20) |
| 12 | Blätter jagen | 3 | erledigt (2026-07-20) |
| 13 | Minispiele (Poker + Messerspiel) | 3 | erledigt (2026-07-20) |
| 13-Rest | Eigenes Kartenspiel | — | offen (Stretch, kein v1-Ziel) |
| 17 | Poker: echte Karten + Figuren am Tisch | Politur | offen |
| 18 | Viertes Geschwader (Ridoc/Sawyer/Liam/Dain) | Politur | offen |
| 19 | Stimmen-Schreibpass (Dialoge) | Politur | offen |
| 20 | Viadukt-Respawn-Fix (Bug) | Politur | offen |
| 21 | Blätter-Jagd (Black-Flag-Gefühl) | Politur | offen |
| 22 | Journal/Lexicon-Texte | Politur | offen |
| 23 | Asset-Import-Grundausstattung (Quaternius) | Politur | **erledigt (2026-07-21)** — 296 Modelle sortiert unter `assets/models/`, Rig-Kompatibilität in `scenes/test/asset_pipeline_test.tscn` verifiziert |
| 24 | Primitiven-Austausch in den echten Szenen | Politur | offen — Folge-Schritt aus CR 23, Pipeline steht |
| 14 | Aula-Bau + Tür-Fix | 1 | erledigt (2026-07-19) |
| 15 | Hub-Layout an Karte | 1 | erledigt (2026-07-19) |
| 16 | Permadeath raus → Save/Camp | 1 (Camp: Akt 2) | erledigt (2026-07-19); Camp-Rest: Akt 2 |

View file

@ -12,7 +12,7 @@ Third-Person-**Action-RPG** im ersten Ausbildungsjahr an einer
Drachenreiter-Akademie. Spieler ist Tyrveil, ein Gezeichneter. **Zwei
gleichrangige Kern-Pfeiler:** (1) eine dichte **Story** (Beziehungen,
Tageszyklus, Drachen-Bindung) und (2) echter **Action-Kampf** — freie Bewegung,
Kombos, Waffenklassen, mit RPG-Stats hinterlegt (Details: CHANGEREQUESTS.md CR 8).
Kombos, Waffenklassen, mit RPG-Stats hinterlegt (Details: §6, „Kampfsystem").
Kein MMO, sondern ein Einzelspieler-Action-RPG in einer 3D-Welt.
Privates Fan-Projekt (siehe Rechtehinweis in README.md).
@ -134,6 +134,25 @@ Kaoris Klassenzimmer statt der architektonischen Buch-Rotunda): **ORTE.md**.
## 6. Systeme
- **Stats**: Kraft, Schnelligkeit, Verstand (steigen über Aktivitäten).
- **Kampfsystem (Action-RPG, gebaut über CR 8a–8e):** Echtzeit-Action MIT
RPG-Stats — Skill UND Werte zählen.
- **Reichweite:** Kampf nur in **definierten Encounter-Zonen/Szenen** (Sparring,
Tag-9-Hinterhalt, gesetzte Encounter) — **kein Welt-Sandbox**, keine roamenden
Gegner im Hub. Der Hof bleibt sozialer Raum.
- **Grammatik:** leichter Angriff, schwerer Angriff, **Ausweichen** (schneller
Seitenschritt zur Positionierung, **ohne** i-Frames), **Dodgen** (Rolle **mit**
Unverwundbarkeits-Fenster, Ausdauer-Kosten), Block/Parry, **Kombos**.
**Magie im Kampf erst ab Akt 2** (vor der Bindung hat Tyrveil keinen Drachen).
- **Waffen:** Dolch (schnell, kurz), Schwert (Mitte), Axt (langsam, wuchtig);
**jederzeit wechselbar**. Balancing-Kernregel: **gleiche DPR** über alle
Klassen — die Wahl ist **Stil, nicht Stärke**.
- **Waffenskill pro Waffenart getrennt** (Dolch/Schwert/Axt unabhängig): Skill
schaltet Kombos/Optionen frei und senkt Ausdauerkosten / weitet Fenster —
**hebt NICHT den Rohschaden**, damit „gleiche DPR bei gleichem Skill" gilt.
- **Rüstungen:** Trade-off **Schutz ↔ Tempo** (kein „mehr = besser").
- **Stats-Kopplung:** Kraft→Schaden, Schnelligkeit→Angriffs-/Ausweich-/
Dodge-Tempo & Block-/Konterfenster, Verstand→Gegner-Lesen/Konter-Hilfen.
- Viadukt und Gauntlet bleiben **Geschicklichkeit**, kein Kampf.
- **Klinge-↔-Herz-Achse**: Ton-Wert (-100 Klinge .. +100 Herz), gesetzt durch
Dialog-Entscheidungen. Färbt Reaktionen, Fraktion, Bindungs-Daumen.
- **Beziehungswerte** pro NPC (-100..+100).