windgeschworen/docs/CHANGEREQUESTS.md
danny cba2dfe1ec CR 20: Viadukt respawnt am Checkpoint statt am Spielstand
Der Sturz in die Nebelschlucht setzt Tyrveil jetzt am zuletzt erreichten
Checkpoint wieder ab — ohne Szenenwechsel, ohne Laden. Wurde noch keiner
beruehrt, beginnt der Lauf am Steganfang. Damit verhalten sich die beiden
Set-Pieces mit Checkpoints gleich; reload_last_save() bleibt den Story-Toden
vorbehalten, Tag-9-Hinterhalt und Dreschen-Pruefung. SPEC §6 haelt die
Checkpoint-Ausnahme jetzt fest.

Player.reset_motion() loescht beim Respawn Geschwindigkeit und Fremdschub,
damit der Sturzimpuls nicht mit auf den Steg zurueckkommt.
BalanceQTE.cancel() bricht ein noch laufendes QTE ueber einen
Generations-Zaehler ergebnislos ab — sonst haette die wartende Coroutine den
frisch abgesetzten Spieler sofort wieder heruntergestossen.

Dabei aufgefallen und nach Autoren-Entscheidung mitbehoben: Der Wind wirkte
als Beschleunigung statt als Zusatz-Geschwindigkeit. player.gd addierte
external_push pro Frame, waehrend die Abklingrechnung im Stillstand den
Windanteil des Vorframes erneut einlas — die Seitwaertsgeschwindigkeit lief
von 0 auf -21 m/s in einer Sekunde davon, bei konstantem Schub von -0,7. Der
Fehler war Altbestand und nur unsichtbar, weil der Tod bisher die Szene neu
lud; mit dem Checkpoint-Respawn haette er sofort wieder heruntergeblasen.
_process_normal() zieht den zuletzt angewandten Schub jetzt zu Frame-Beginn
ab. Gemessen danach: konstant 0,70 m/s, 1,07 m Versatz in 1,5 s. Das Viadukt
wird dadurch spuerbar gutmuetiger.

Gauntlet unveraendert.

Verifiziert mit dev_cr20_probe (19/19) und einem Boot-Check ueber acht
Szenen; Sonde vor dem Commit geloescht.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-21 18:46:48 +02:00

235 lines
14 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.
---
# 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).
## 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
> 10-Tage-Zyklus (TimeSystem, Greybox-Räume, „Die Grauen"/Barks, Cassian +
> Tag-9-Hinterhalt, Imogen-Abendszenen, Stat-pro-Raum, Wren-Eskorte, Codex) ist
> bereits erledigt und steht NICHT nochmal hier.
> 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-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**._