windgeschworen/docs/CHANGEREQUESTS.md
danny 52fd2a34f4 CR 33c: Dreschen als eigene Szene dragon_vale.tscn
Loest das Dreschen aus dem alten gemeinsamen Set-Piece in eine eigene,
weglos erkundbare Tal-Szene (ORTE.md/THE_VALE.md: ein Tal, zwei Zonen).

- Aeusserer, zugaenglicher Bereich: verstreute Drachen-Silhouetten,
  Schluchten (schraege Fels-Boxen), Waldstueck, 2-3 Nest-Cluster. Kein
  Leitpfad. Nest-Annaeherung loest einen kurzen Pruefungs-Beat aus
  (Muster dragon_distraction.gd): Silhouetten-Regung + Warnzeile, ohne
  Steuerungssperre, mit Abklingzeit.
- Dahinter per Nebel-/Ward-Grenze das gesperrte Nistheiligtum: feste
  Wand, Kulisse mit unerreichbaren Silhouetten, sichtbar aber nicht
  betretbar.
- Smaladhs fixe Bindung in einer aschfahlen, sichtbar abgesetzten Nische
  im zugaenglichen Bereich (nicht im Heiligtum). Bindungs-Koroutine
  verbatim aus hatching_grounds.gd uebernommen.
- Tuer-Graph (Kanon-sauber, per Rueckfrage entschieden): Vale-Steintreppe
  -> Hof (Spawn FromHatching); Hof-Wiedereintritt "Hinab ins Tal"
  (grief_state, Akt-2-Trauer) -> dragon_vale statt hatching_grounds.

Verifikation: Headless-Probe 20/20 (Gelaende, Palette, Ward-Kulisse,
Bindungs-Verdrahtung, Bereits-gebunden-Pfad, Tuer-Graph), Boot-Check
aller betroffenen Szenen 0 Fehler.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-28 19:49:56 +02:00

195 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# CHANGEREQUESTS.md — Windgeschworen
> Hier schreibe ich Änderungen auf, die mir während dem Testen auffallen. Bitte arbeite diese bei jeder Phase vorher ab, sodass hier immer alles erledigt ist.
>
> Erledigte Punkte löschst du bitte, damit diese nicht aus Versehen doppelt gemacht werden. Die erledigten Punkte sollen dann bitte in die Datei CHANGEREQUESTS_DONE.md übertragen werden, mit einer kurzen Anmerkung von dir, wann es geändert wurde und was du genau getan hast.
---
## 33. Präsentation & Dreschen — Umbau (Mike/Karsten/Charlie-Paket, 2026-07-22)
> Ersetzt den aktuellen Zustand: Weg zum Dreschen ist jederzeit offen, es gibt
> keine Gauntlet-Trainingszeit, Präsentation und Dreschen sind dieselbe Szene.
> Räumliches Konzept von Mike (verifiziert), Story-Texte von Karsten/Charlie
> (verifiziert gegen STIMMEN.md + sechs Anti-Muster). Docs bereits
> nachgezogen: ORTE.md, THE_VALE.md (Vale/Tal-Auflösung), STORY.md (Epilog,
> Akt-3-Augen-Bogen, Klimax-Cassian-Absatz, Akt-2-Auftakt). Reihenfolge unten
> ist Bau-Reihenfolge.
### 33a. Gauntlet: Training vs. Ernstlauf — ✅ ERLEDIGT (2026-07-23, Commit s. DONE)
### 33b. Präsentation — neue Szene `flight_field.tscn` — ✅ ERLEDIGT (2026-07-28, Commit s. DONE)
### 33c. Dreschen — neue Szene `dragon_vale.tscn` — ✅ ERLEDIGT (2026-07-28, Commit s. DONE)
> Tür-Graph: „Kanon-sauber" gewählt (Rückfrage). Vale-Steintreppe → Hof
> (Spawn `FromHatching`); Hof-Wiedereintritt „Hinab ins Tal" (grief_state)
> → `dragon_vale.tscn`; Flugfeld-Tür „Weiter ins Tal" → `dragon_vale.tscn`.
### 33d. Cassians Dreschen-Finale
- `data/dialogue/cassian_dreschen.json` (Karsten, verifiziert) liegt bereit.
Zwei Startknoten (`open_blade`/`open_heart`) je nach `cassian_choice` —
**kein Schema-Umbau am DialogueSystem** (`variant_by` ist kein reales
Feld): Das Encounter-Trigger-Skript im Tal liest `cassian_choice` selbst
und ruft `start_dialogue()` direkt mit dem passenden Startknoten auf.
- Cassian hat den Tag-9-Hinterhalt in beiden Ausgängen überlebt (Code
bestätigt das bereits — `_lay_cassian_down()` bzw. `.visible = false`
bestätigen nie seinen Tod). Konfrontiert Tyrveil im Tal, Kampf über das
bestehende **CR-8-Encounter-System**, Ausgang fix: Tyrveil siegt.
- **`kampf`-Knoten = Pause-Marker**, kein Szenen-Split: Encounter läuft, nach
Sieg setzt derselbe Dialogbaum bei `am_boden` fort (Muster wie
`cassian_ambush.gd`s QTE-Kette).
- **Augen-Effekt beim `toeten`-Knoten** (Text liegt bereits vor): Kamera-Zoom
aufs Gesicht, Tyrveils Pupillen färben sich zum ersten Mal pechschwarz,
Zoom raus, Tyrveil stößt Cassian dessen eigenes Schwert ins Herz. Technisch:
bestehendes `googly_eyes.tscn` nutzen — `LeftPupil`/`RightPupil` einfärben/
skalieren, kein neues Asset. **Erstes Auftreten eines Motivs, das in Akt 3
eskaliert** (STORY.md §9) — lohnt sich als wiederverwendbare Komponente zu
bauen, nicht als Einmal-Hack.
- **Herz-Pfad-Konsequenz (entschieden):** Der erzwungene Kill drückt
Menschlichkeit/Ton leicht (Vorschlag: `shift_humanity(-2)`, kleiner als der
ursprüngliche Tag-9-Ausschlag von ±3 — Bestätigung/Anpassung bei Bedarf).
- **Akzeptanz:** Cassians Bogen ist nach dieser Szene endgültig geschlossen,
unabhängig vom Tag-9-Ausgang; Augen-Effekt sichtbar in Greybox; Herz-Pfad
zeigt den Malus.
### 33e. Epilog — Smàladh-Flug (ersetzt Imogen/Wren-Text)
- `data/dialogue/epilog_smaladh.json` (Karsten, verifiziert) liegt bereit.
Nicht-interaktive Sequenz (**kein Flug-Gameplay**, SPEC §11). STORY.md §5
ist bereits entsprechend umgeschrieben.
- **Akzeptanz:** Sequenz ist reine Kamerafahrt/Dialog, keine Spielersteuerung
über den Flug; endet mit Schnitt in den Akt-2-Ladebildschirm.
### 33f. Akt-2-Auftakt — Staffel-Wiedersehen
- `data/dialogue/akt2_auftakt_staffel.json` (Charlie, verifiziert) liegt
bereit. Werte (`blade_heart +10/-5`, `relationship.imogen +3` im
Imogen-Wahl-Beat) sind vom Autor bestätigt, unverändert übernehmen.
STORY.md §9 ist bereits mit dem Auftakt-Absatz versehen.
- Trigger: direkt nach dem Laden in Basgiath (Akt-2-Start), einmalig.
- **Akzeptanz:** Szene läuft automatisch beim ersten Akt-2-Start; Wren bleibt
nachweislich unbeantwortet; Imogen-Wahl setzt die dokumentierten Deltas.
# 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.
## 25. Absturz beim Türen-/Zonenwechsel — IN BEOBACHTUNG (Härtung + Forensik drin, 2026-07-21)
> Autor: „Das Game crasht öfters, wenn man durch Türen geht" — Symptombild laut
> Rückfrage: **Fenster minimiert sich, Standbild**, immer andere Türen.
- **Untersuchungsstand (2026-07-21, Claude):** In vier eskalierenden
Reproduktions-Aufbauten (headless direkt, Doppel-Trigger im selben Frame,
windowed, windowed mit echtem Physik-body_entered und stehender Absage) über
**175+ Türwechsel kein Absturz und kein einziger Fehlertext**. Die
Verdachtsstelle aus der ursprünglichen CR (zone_trigger-await) ist in Godot
4.7 nachweislich still: Coroutinen auf freigegebenen Instanzen brechen stumm
ab, gebundene Timer-Signale werden beim Freigeben getrennt, freigegebene
Objekte vergleichen sich gleich null. Die gesamte
„freed instance"-Fehlerklasse scheidet als Ursache aus.
- **Trotzdem gehärtet (echte, wenn auch stille Fehler):**
1. `zone_trigger.gd`: Absage-Rücksteller läuft über einen Kind-Timer statt
await — kein Zombie-Rest nach dem Wechsel.
2. `dialogue_system.gd` + `dialogue_box.gd`: Stirbt die Szene unter einem
laufenden Dialog weg (Auto-Start-Szenen wie Appell/Ankunft können mit
einem Türtrigger um denselben Frame rasen), endete der Dialog vorher NIE —
die Autoload-Coroutine hing für immer im choose()-Await und legte die
Box über die neue Szene. Jetzt endet er sofort und still.
- **Forensik für den nächsten Vorfall:** Log-Aufbewahrung auf 30 Dateien erhöht
(`debug/file_logging/max_log_files`) und jeder Türwechsel schreibt eine
`[tuerwechsel]`-Zeile ins Log. **Beim nächsten Standbild bitte:** Spiel
abschießen, dann die neueste Datei aus
`%APPDATA%/Godot/app_userdata/Windgeschworen/logs/` sichern und hierher —
die letzten Zeilen zeigen dann, was unmittelbar vor dem Einfrieren lief.
- **Offen:** Ursache unbestätigt. Kandidaten jenseits der Skript-Ebene
(Treiber/Vulkan-Stall beim ersten Betreten einer Szene, Fokus-Verlust im
Editor-Vollbild) lassen sich erst mit einem echten Log belegen.
## 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.
## 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.
- Ab **Akt 2** (nach Dreschen + erstem Flug) gibt es neben Klinge/Herz eine dritte
Antwort-Sorte, die die **Bindung zu Smàladh** (neuer verdeckter Wert 0–100) hebt.
Existiert erst NACH der Bindung (vorher kein Drache).
- Zwei getrennte Effekte:
- **Siegelkraft-Stärke** skaliert mit der Bindung.
- **Kanalisierungs-Ausdauer** (wie lange die Siegelkraft gehalten werden kann,
bevor man ausbrennt) skaliert ebenfalls — kanonisch (Kanalisieren laugt aus).
- Bindungs-Antworten in Smàladhs Ton (Kopf-an-Kopf; dragons/SMÀLADH.md). Zulieferer:
Drachenpflege (CR 10).
- Default (korrigierbar): Wert **verdeckt** wie der Menschlichkeits-Messwert;
Feedback über spürbare Smàladh-Reaktionen.
## 10. Drachenpflege (Bonding-Aktivität, ab Akt 2)
> Kaddis-Runde 2.
- Nach der Bindung: um Smàladh kümmern — **Krallen schärfen, Schuppen säubern,
streicheln**. Eigene Aktivität (Tagesslot) am Flight Field
(locations/outdoor/FLIGHT_FIELD.md).
- **Speist die Bindungs-Achse** (CR 9) → Siegelkraft & Kanalisierungs-Ausdauer.
- **Ton-Regel:** Smàladh ist kein Schoßtier — er *duldet* die Pflege erst, dann
schätzt er sie; das erste zugelassene Streicheln ist ein echter Meilenstein.
- Default: kleine Interaktion (leichtes QTE/Rhythmus), einmal pro Tag (Anti-Farming).
## 13. Eigenes Kartenspiel (Stretch aus CR 13)
> Rest-Umfang nach der Umsetzung von Poker und Messerspiel (2026-07-20).
- Ein **eigenes Kartenspiel** mit eigenem Regelwerk am Spieltisch der Aula —
bewusst als späterer Stretch markiert, kein v1-Ziel.
- Setzt auf dem fertigen Tisch auf: `game_table.gd` wählt Spiel, Gegner und
Einsatz bereits generisch aus `data/minigames/table_games.json`; ein neues
Spiel braucht einen Eintrag unter `games` und eine UI-Szene mit einer
`play()`-Coroutine.
---
## Phasen-Plan (Reihenfolge für den Entwickler-Claude)
> _Status (2026-07-21, Claude): **Wellen 0–3 sind komplett abgearbeitet**
> (Phasen 0–11, CR 1–16, CR 8a–8e Kampfsystem, CR 11–13 Flavor) — **der
> v1-Umfang ist inhaltlich beisammen.** Zusätzlich erledigt: **CR 23**
> (Asset-Pipeline mit fünf Quaternius-CC0-Packs steht und ist verifiziert)._
>
> _Offen, in Prioritätsreihenfolge:_
> - **Politur-Welle CR 17–22** (Findings aus dem Akt-1-Testdurchlauf) — voll
> spezifiziert, bereit zur Umsetzung, noch nicht dispatcht. Reihenfolge:
> CR 20 (Bugfix, klein) → CR 18 (Viertes Geschwader) → CR 17 (Poker) →
> CR 21 (Blätter) → CR 19+22 (Schreibpass, ein Durchgang).
> - **CR 24** (Primitiven-Austausch, Folge-Schritt aus CR 23) — zwei offene
> Autoren-Entscheidungen zuerst klären (Textur-Downscale 4K→1K/2K?,
> Blender-Trimm-Schritt für den Basis-Körper bestätigen), dann Szene für
> Szene umsetzen.
> - **CR 13-Rest** (eigenes Kartenspiel) — Stretch, kein v1-Ziel, keine Eile.
> - **Welle 4 (Akt 2, jenseits v1):** CR 9, CR 10, CR 8-magie, CR-16-Rest
> (Camp) — alle setzen die Bindung an Smàladh voraus. **Nächster
> inhaltlicher Schritt davor ist KEIN Code, sondern Story:** Akt 2 ist in
> STORY.md §9 ausdrücklich „noch auszuarbeiten" — ohne ihn hängen diese
> drei CRs in der Luft.
>
> _Vollständige, gewichtete Reihenfolge in Wellen: **ROADMAP.md**._