windgeschworen/docs/CHANGEREQUESTS.md
danny 37f7ca4e5b CR 25: Tuerwechsel-Crash — Haertung + Forensik, Ursache noch offen
Untersuchung: In vier eskalierenden Reproduktions-Aufbauten (headless direkt,
Doppel-Trigger im selben Frame, windowed, windowed mit echtem
Physik-body_entered und stehender Absage) ueber 175+ Tuerwechsel kein Absturz
und kein einziger Fehlertext. Die Verdachtsstelle aus der 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-Klasse scheidet als Ursache aus. Symptombild laut
Rueckfrage (Fenster minimiert sich, Standbild, wechselnde Tueren) passt zu
einem Stall oder Fokus-Verlust jenseits der Skript-Ebene — das laesst sich
erst mit einem echten Log belegen.

Trotzdem gehaertet, weil beim Suchen zwei echte (stille) Fehler auffielen:
zone_trigger stellt das Absage-Label jetzt ueber einen Kind-Timer statt await
zurueck — kein Zombie-Rest nach dem Wechsel. Und stirbt die Szene unter einem
laufenden Dialog weg (Auto-Start-Szenen wie Appell koennen mit einem
Tuertrigger um denselben Frame rasen), endete der Dialog vorher NIE: die
Autoload-Coroutine hing fuer immer im choose()-Await und legte die Box ueber
die neue Szene. DialogueSystem prueft jetzt pro Frame, ob die Sprecher noch
leben, und beendet den Dialog still; die Box kann eine offene Auswahl von
aussen aufloesen.

Forensik fuer den naechsten Vorfall: Log-Aufbewahrung auf 30 Dateien erhoeht
und jeder Tuerwechsel schreibt eine [tuerwechsel]-Zeile ins Log. Beim
naechsten Standbild die neueste Datei aus
%APPDATA%/Godot/app_userdata/Windgeschworen/logs/ sichern.

CR 25 bleibt in CHANGEREQUESTS.md als IN BEOBACHTUNG stehen. Die
Autoren-Docs dieser Runde (STIMMEN.md neu, SPEC/CHARACTERS-Anpassungen,
CR 25-27) fahren mit diesem Commit ein.

Verifiziert mit einer Regressions-Sonde (5/5: Kind-Timer aktiv, Wechsel mit
stehender Absage sauber, Dialog endet still bei toten Sprechern, 15 weitere
schnelle Wechsel) und einem Boot-Check ueber 13 Szenen; Sonden vor dem Commit
geloescht.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 20:20:45 +02:00

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


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.

26. Stimmen-Schreibpass fertigstellen — 31 Dateien fehlen noch

Folge aus CR 19+22 (committed 2026-07-21, f058782). Der Commit selbst ist sauber verifiziert (Struktur-Fingerabdruck vorher/nachher ohne Abweichung) und hat 11 Dateien wirklich verbessert — aber die CR verlangte alle Dialogbäume, nicht nur Xaden/Violet/Imogen/Cassian. Klarstellung, damit die Lücke nicht nochmal über „alle, mit Priorität auf X" mehrdeutig gelesen wird:

  • Bereits erledigt, NICHT nochmal anfassen: cassian_ambush_choice, imogen_intro, imogen_night_5, violet_intro, violet_trauer, xaden_intro, xaden_trauer, xaden_zirkel_bestaetigung, xaden_zirkel_danach, xaden_zirkel_frueh, xaden_zweitsignet (CR 19+22); dain_intro, liam_intro, ridoc_intro, sawyer_intro, staffel_appell, ambient_lines (CR 18 — laut Commit-Notiz bereits beim Schreiben gegen die sechs Muster geprüft).
  • Noch zu prüfen und ggf. neu zu schreiben — vollständige Liste (31 Dateien): ankunft, cassian_ambush_fail, cassian_ambush_intro, cassian_angebot, cassian_intro, cassian_warnung, gauntlet_death, gauntlet_grief, gauntlet_intervention, gauntlet_start, imogen_night_1, imogen_night_2, imogen_night_3, imogen_night_4, imogen_night_5_kalt, imogen_night_6_schwur, imogen_trauer_herz, imogen_trauer_klinge, jack_fail, jack_intro, jack_win, maren_intro, rhiannon_intro, rhiannon_trauer, sparring_loss, sparring_win, viaduct_wren, wren_eskorte, wren_intro, wren_trauer_herz, wren_trauer_klinge.
  • Verfahren identisch zu CR 19: Struktur-Fingerabdruck vor/nach ziehen und vergleichen (Beweis, dass nur der Ton sich ändert), sechs Anti-Muster anwenden (CHANGEREQUESTS-Historie/CR 19 nachlesen), Stimmen-Quellen die jeweiligen Akten in humans/ + CHARACTERS.md + STIMMEN.md (neu: konkrete Länge/Sprachmuster/Emotions-/Entwicklungsregeln pro Charakter — verbindlich für diesen Schreibpass). Reiner Schreibpass — keine Story-Fakten, Flags, Effekte, Verzweigungen (Ton ≠ Ausgang, STORY §6).
  • Akzeptanz: Alle 31 gelisteten Dateien sind gegen die sechs Muster geprüft; jede tatsächliche Änderung ist im Fingerabdruck-Vergleich strukturgleich zum Vorher; keine der bereits erledigten 17 Dateien wird erneut angefasst.

27. Poker wird echtes Texas Hold'em (ersetzt CR-17-Umsetzung)

Autor-Entscheidung (2026-07-21): Die CR-17-Umsetzung (poker_game.gd) ist eine einzige Setzrunde mit je 5 verdeckten Karten ohne Kartentausch — fühlt sich nicht wie Poker an. Ersetzt durch echtes Texas Hold'em. Meine ursprüngliche CR 17 hat die Variante nie festgelegt — das war eine Spezifikations-Lücke, keine falsche Umsetzung.

  • Regeln:
    • Jeder Spieler bekommt 2 verdeckte Handkarten (Hole Cards).
    • Gemeinschaftskarten werden in drei Schritten aufgedeckt: Flop (3 Karten auf einmal), Turn (1 Karte), River (1 Karte).
    • Vier Setzrunden, je eine nach: Hole Cards (Pre-Flop), Flop, Turn, River. Optionen: Checken (wenn niemand gesetzt hat), Mitgehen, Erhöhen, Aussteigen.
    • Blinds statt reinem Ante: Kleiner/großer Blind wechseln pro Runde zwischen Spieler und Gegner (Heads-up-Poker, 1 gegen 1).
    • Showdown: beste 5-Karten-Hand aus den 7 verfügbaren (2 eigene + 5 Gemeinschaftskarten).
  • Technische Delta-Notiz (aus Code-Lektüre): CardDeck.evaluate() nimmt aktuell genau 5 Karten an (Flush-/Straight-Prüfung geht von exakt 5 Werten aus). Für Hold'em wird eine Best-of-7-Bewertung gebraucht (die beste 5-Karten-Kombination aus 7 testen, 21 Kombinationen) — das ist eine echte Erweiterung, kein Aufruf-Detail.
  • Gegner-KI: _decide() muss über mehrere Straßen hinweg konsistent bluffen/einschätzen (aktuell nur einmalig), inkl. steigendem Pot über die Runden. skill/bluff_rate pro Gegner bleiben als Konzept erhalten.
  • UI: Gemeinschaftskarten-Reihe zwischen den beiden Händen, die sich nach Flop/Turn/River sukzessive füllt — genau das „Kartenaufdecken", das der Autor vermisst hat. Eigene Hole Cards bleiben offen, Gegner-Hole-Cards verdeckt bis zum Showdown.
  • Betrifft: poker_game.gd (weitgehende Neufassung), card_deck.gd (Best-of-7-Bewertung), card_view.gd (Gemeinschaftskarten-Layout), data/minigames/table_games.json (Runden-Konfiguration anpassen). Platzhalter-Karten-Prinzip aus CR 17 bleibt (Bau wartet nicht auf PNGs).
  • Akzeptanz: Eine Partie läuft über Pre-Flop/Flop/Turn/River mit je einer Setzrunde; Gemeinschaftskarten decken sich sichtbar auf; Showdown wählt korrekt die beste 5-aus-7-Kombination beider Seiten; Blinds wechseln pro Runde. Messerspiel bleibt unverändert (nutzt kein Kartenblatt).

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.