windgeschworen/docs/CHANGEREQUESTS.md
danny 8cc33df12e CR 33a: Gauntlet-Training an jedem Tag, Ernstlauf nur im Zulassungsfenster
Bisher loeste der erste Gauntlet-Besuch immer den manipulierten Ernstlauf aus.
Jetzt gilt in _init_mode_and_story() eine zusaetzliche Bedingung: EXAM nur,
wenn act_one_completed gesetzt UND maren_death noch nicht erreicht ist — der
Morgen nach dem Tag-10-Schwur. An allen anderen Zeitpunkten, waehrend der zehn
Tage wie nach dem Wendepunkt, ist der Gauntlet freies, sicheres Training
(Checkpoint-Respawns, keine Rivalen, Maren/Wren/Intervention entfernt).

Marens Tod bleibt an den Ernstlauf gebunden und damit fix. Kein Neubau, nur
die eine Bedingung — der Exam-Zweig ist unveraendert.

Verifiziert mit dev_cr33a_probe (12/12: Training waehrend Akt 1, EXAM im
Fenster mit praesenter Maren und manipuliertem Lauf, Training nach dem
Wendepunkt, kein zweiter Ernstlauf) und einem Boot-Check ueber fuenf Szenen;
Sonden vor dem Commit geloescht.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-28 19:19:10 +02:00

14 KiB
Raw Blame History

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

  • Gauntlet-EndTrigger (target_scene_path) von hatching_grounds.tscn auf flight_field.tscn umhängen; Label „Zur Präsentation" bleibt korrekt (Kanon: Flugfeld liegt am Kopf des Gauntlets, FLIGHT_FIELD.md).
  • Greybox: langgestreckte Talmulde (Boden-Box, drei Seiten Fels-Boxen, vierte = Abstieg zum Gauntlet), mittiger „Feldweg" als schmale Marschroute, Halbkreis aus Drachen-Silhouetten (bestehende _make_dragon()-Funktion aus dem Gauntlet-Code wiederverwenden, größer/zahlreicher).
  • Ablauf: kontrollgesperrte Marsch-Sequenz (Muster der bestehenden _run_presentation()-Koroutine aus hatching_grounds.gd, hierher verlegt). Niemand aus Tyrveils eigener Staffel stirbt (feste Regel). Aus benachbarten Staffeln: einzelne Ambient-Schreie (nicht sichtbar). Ein gescripteter Schock-Beat: ein „Grauer" stolpert/zittert, wird sofort von einem Drachen exekutiert, Formation muss (Kontrolle gesperrt) weitermarschieren.
  • praesentation_done-Flag (existiert bereits) schaltet danach die Tür „Weiter ins Tal" frei.
  • Akzeptanz: Präsentation läuft als eigene, einmalige Sequenz vor dem Dreschen; Tyrveils Staffel-Kameraden überleben garantiert; der Exekutions-Beat ist sichtbar, aber steuerungsgesperrt.

33c. Dreschen — neue Szene dragon_vale.tscn

  • Vale/Tal-Auflösung (entschieden, s. ORTE.md/THE_VALE.md): Ein Tal, zwei Zonen — äußeres, nur am Dreschen-Tag zugängliches Gelände (Schluchten, Wald, sichtbare Nester) + per Nebel-/Ward-Grenze abgetrennt das tiefere, dauerhaft gesperrte Nistheiligtum aus THE_VALE.md (Kulisse, nicht begehbar, Buch-2/3-Tiefenwissen über denselben Ort).
  • Greybox: mehrere unterschiedlich hohe Boden-Patches, Schluchten (schmale Korridore zwischen hohen schrägen Fels-Boxen), Waldstück (Zylinder-Stämme + Kegel/Kugel-Kronen), 2-3 Nest-Cluster. Kein Leitpfad, mehrere Zugänge. 12-20 Drachen-Silhouetten verteilt (nicht 100 simulierte Individuen — die meisten bleiben laut Kanon unsichtbar). Nest-Annäherung triggert einen kurzen Prüfungs-Beat nach dem Muster von dragon_distraction.gd.
  • Smàladhs fixe Bindung: eigene, sichtbar abgesetzte Nische (aschfahle statt warme Palette — „verbrannt/verlassen") im äußeren, zugänglichen Bereich, NICHT im gesperrten Heiligtum. Bestehende Bindungs-Koroutine aus hatching_grounds.gd (Herantreten, Dialog, Signet-Wurf, Speicherung) dorthin verlegen, weitgehend unverändert.
  • Hof-Rückkehrtür („Hinab ins Tal") umbenennen auf „Die Steintreppe — hinauf zum Flugfeld" (Kanon-Beleg: GAUNTLET.md, separate Steintreppe für Absolventen), zeigt auf dragon_vale.tscn.
  • Akzeptanz: Tal ist frei erkundbar, wegloses Gelände, Smàladh eindeutig über die Palette abgesetzt auffindbar; gesperrtes Heiligtum ist sichtbar, aber nicht betretbar.

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.gds 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.