diff --git a/docs/CHANGEREQUESTS.md b/docs/CHANGEREQUESTS.md index 41b4965..51ab090 100644 --- a/docs/CHANGEREQUESTS.md +++ b/docs/CHANGEREQUESTS.md @@ -6,6 +6,70 @@ --- +# CR 49 — `story_flag` an Knoten wird nie gesetzt (112 Flags in 56 Dateien) + +> Aufgefallen bei der Fassung-C-Umstellung (Karsten, 2026-09-11). **Eine kleine +> Engine-Änderung, die auf einen Schlag 112 Flags repariert.** Die Alternative — +> alle Flags von Hand in Optionen umzuziehen — geht nicht, weil viele davon an +> Endknoten ohne Optionen hängen. + +## Befund (verifiziert im Code) +`scripts/autoloads/dialogue_system.gd` setzt `story_flag` ausschließlich in +`_apply_option_effects()` — und das wird nur für eine **gewählte Option** +aufgerufen (einzige Aufrufstelle, ~Z. 385). Ein `story_flag` direkt auf einem +**Knoten** wird gelesen, aber nie angewendet. + +Die Autorendateien benutzen seit Akt 2 durchgängig beides. Gezählt: + +| | | +|---|---| +| Flags, die **nur** an Knoten gesetzt werden | **112** | +| betroffene Dateien | **56** (Akt 2: 87 Flags, Akt 3: 26) | + +## Was davon heute schon still kaputt ist + +**Per `requires_flag` abgefragt — diese Optionen erscheinen nie:** + +| Flag | gesetzt (Knoten) | abgefragt | +|---|---|---| +| `spur_aushebungen` | `akt2_k2_markham_warnung` / `ende` | `akt2_k5_jesinia` / `j_worum` | +| `zwischenspiel_abgeschlossen` | `akt2_zw_luecke` / `schwarz` | `akt2_rueckflug_bodhi` / `d_start` | + +**Abnahmekriterium eines erledigten CRs verfehlt:** CR 36 verlangt +„`wren_ungebunden` ist gesetzt und save-persistent". Das Flag steht am Knoten +`akt2_auftakt_staffel` / `wren_ignoriert` — **wird also nie gesetzt.** Mein +Fehler aus dem CR-36-Textteil; mit dieser Engine-Änderung wäre er ohne +Datei-Anpassung behoben. + +**Kapitel-Abschlüsse, auf die spätere Akte bauen:** `akt2_abgeschlossen`, +`resson_angeflogen` (die `voraussetzung` von Akt 3 im Manifest), `liam_tot`, +`zweite_kraft_erwacht`, `tyrveil_gilt_als_tot`, `akt3_abgeschlossen`. Der Runner +prüft die Voraussetzung heute nicht, deshalb läuft Akt 3 trotzdem — spätestens +Akt 4 würde es aber nicht mehr. + +**Nicht betroffen, geprüft:** Alle Flags, an denen die Akt-3-Verzweigungen hängen +(`luecke_geloescht`, `luecke_behalten`, `coran_brief`, `resson_rowdy`, +`resson_wasser_geholt`, `kinder_gerufen`), sitzen auf **Optionen** und +funktionieren. + +## Soll +Beim Abspielen eines Knotens dessen `story_flag` anwenden — mit **demselben +Erster-Durchlauf-Schutz** wie die Options-Effekte (`_is_effect_pass`), sonst +setzt ein zweiter Durchlauf Flags doppelt oder zurück. Naheliegende Stelle: dort, +wo `node_started` gesendet wird. + +**Keine Datei muss dafür angefasst werden.** + +## Akzeptanz +- Ein Knoten mit `story_flag` setzt das Flag, sobald er gespielt wird. +- `wren_ungebunden` ist nach dem Akt-2-Auftakt gesetzt (holt CR 36 nach). +- Die zwei Optionen `akt2_k5_jesinia` / `j_worum` und + `akt2_rueckflug_bodhi` / `d_start` erscheinen, wenn ihre Vorgeschichte gespielt + wurde. +- Ein Testlauf von Akt 2 + 3 endet mit `akt3_abgeschlossen = true`. + +--- + # CR 46 — Szenen verdrahten: 56 von 57 Dateien sind nicht im Spiel > **Der Posten mit dem größten Missverhältnis** (Karsten, 2026-08-23): Akt 2 und