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>
205 lines
13 KiB
Markdown
205 lines
13 KiB
Markdown
# 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**._
|