windgeschworen/scripts/autoloads/story_system.gd
danny 7830c0b67c v1-Ausbau Phase 1: 10-Tage-Zyklus mit daten-getriebenem Fahrplan und Story-Messwerten
- TimeSystem: MAX_DAYS 10; try_end_day(location_id) beendet den Tag nur
  am Fahrplan-Ort (Schlafsaal bzw. an Imogen-Abenden ihr Zimmer, sobald
  das Story-Flag imogen_nights_active gesetzt ist - bis dahin bleibt der
  Schlafsaal Tagesende, damit der Slice spielbar bleibt); Ende von Tag 10
  feuert act_one_completed + persistentes Flag statt weiterzuzaehlen
  (Schnitt in den Wendepunkt, Szenen-Kopplung folgt spaeter); Save/Load
  klemmt den Tag auf 1-10; get_slot_id() fuer den Fahrplan-Zugriff
- Fahrplan data/story/days/day_01..10.json: Titel, Phase (tag_1_3/
  tag_4_6/tag_7_8/tag_9_hinterhalt/tag_10_teaser), Tagesende-Ort und pro
  Slot verfuegbare Raeume, erzwungene Szene, Beat-Kennung - exakt nach
  STORY.md Abschnitt 5 (Violets Schwaeche Tag 1, Drohnotiz Tag 4,
  Vaterluege + Cassians Angebot Tag 5, Anrempeln Tag 6, Wren-Eskorten
  Tag 7/8, Hinterhalt Tag 9 Nachmittag als einziger Raum, Imogens
  Schwur Tag 10 Abend)
- StorySystem: laedt den Fahrplan (get_day_plan/get_slot_plan/
  is_room_available/get_forced_scene/get_day_end_location); neue
  Messwerte als Story-Flags im GameState (persistieren automatisch):
  Wren-Vertrauen 0-100 Start 50, Imogen-Offenheit 0-100 Start 60,
  Cassian-Eskalation 0-3, Cassian-Ausgang none/heart/blade validiert;
  Signal story_meter_changed; Menschlichkeit bleibt GameState.humanity
- sleep_trigger: location_id-Export + try_end_day mit Ablehnungs-Hinweis
- Verifikation: Headless-Sonde 43/43 gruen (Fahrplan, Zyklus,
  Tagesende-Orte, Akt-1-Abschluss, Messwerte, Save/Load-Roundtrip);
  Boot-Check fehlerfrei; Phase-1-Block aus CHANGEREQUESTS nach DONE

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

186 lines
6.8 KiB
GDScript
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.

extends Node
## Story-Beats, Story-Flags und der 10-Tage-Fahrplan (Autoload, SPEC.md
## Abschnitt 8; v1-Ausbau Phase 1 nach STORY.md Abschnitt 5).
##
## Beat-Logik (Phase 4c): der Gauntlet-Klimax als geordnete Beat-Kette.
## Der aktuelle Beat liegt als Story-Flag im GameState (FLAG_GAUNTLET_BEAT)
## und reist damit im Spielstand mit. advance_gauntlet_beat() bewegt sich
## nur vorwärts entlang der Kette — der Wendepunkt ist unumkehrbar.
##
## Fahrplan (Phase 1 des v1-Ausbaus): data/story/days/day_01..10.json
## legen daten-getrieben fest, welche Räume pro Slot verfügbar sind,
## welche Szene erzwungen ist und wo der Tag endet (Schlafsaal bzw. an
## Imogen-Abenden ihr Zimmer — Letzteres greift erst ab dem Story-Flag
## imogen_nights_active, damit der Slice spielbar bleibt, bis Imogens
## Zimmer als Raum existiert).
##
## Messwerte (Phase 1): Wren-Vertrauen und Imogen-Offenheit (0–100),
## Cassian-Eskalationsstufe (0–3) und Cassian-Ausgang (heart/blade)
## liegen als Story-Flags im GameState und sind damit persistent; der
## Menschlichkeits-Messwert ist GameState.humanity (Klinge/Herz) und wird
## hier bewusst NICHT dupliziert.
signal gauntlet_beat_changed(new_beat: String)
signal story_meter_changed(meter: String, value: int)
const FLAG_GAUNTLET_BEAT := "gauntlet_beat"
const FLAG_TRUTH_3 := "truth_3_revealed"
const FLAG_IMOGEN_NIGHTS := "imogen_nights_active"
const FLAG_WREN_TRUST := "wren_trust"
const FLAG_IMOGEN_OPENNESS := "imogen_openness"
const FLAG_CASSIAN_ESCALATION := "cassian_escalation"
const FLAG_CASSIAN_OUTCOME := "cassian_outcome"
const WREN_TRUST_START := 50
const IMOGEN_OPENNESS_START := 60
const CASSIAN_ESCALATION_MAX := 3
const CASSIAN_OUTCOMES: Array[String] = ["none", "heart", "blade"]
const DAY_PLAN_PATH := "res://data/story/days/day_%02d.json"
const GAUNTLET_BEATS: Array[String] = [
"none",
"gauntlet_started",
"maren_intervention",
"maren_death",
"truth_1_revealed",
"truth_2_revealed",
"gauntlet_completed",
]
var _day_plans: Array[Dictionary] = []
## Lädt den 10-Tage-Fahrplan aus data/story/days/.
func _ready() -> void:
for day in range(1, TimeSystem.MAX_DAYS + 1):
var path := DAY_PLAN_PATH % day
var file := FileAccess.open(path, FileAccess.READ)
if file == null:
push_error("Tagesplan fehlt: %s" % path)
_day_plans.append({})
continue
var parsed: Variant = JSON.parse_string(file.get_as_text())
if parsed is Dictionary:
_day_plans.append(parsed)
else:
push_error("Tagesplan unlesbar: %s" % path)
_day_plans.append({})
## Liefert den kompletten Tagesplan eines Tages (leer, wenn außerhalb).
func get_day_plan(day: int) -> Dictionary:
if day < 1 or day > _day_plans.size():
return {}
return _day_plans[day - 1]
## Liefert den Slot-Plan eines Tages ("morning"/"afternoon"/"evening").
func get_slot_plan(day: int, slot_id: String) -> Dictionary:
var slots: Dictionary = get_day_plan(day).get("slots", {})
return slots.get(slot_id, {})
## Prüft, ob ein Raum laut Fahrplan im Slot verfügbar ist.
func is_room_available(room_id: String, day: int, slot_id: String) -> bool:
var rooms: Array = get_slot_plan(day, slot_id).get("rooms", [])
return rooms.has(room_id)
## Liefert die im Slot erzwungene Szene ("" = keine).
func get_forced_scene(day: int, slot_id: String) -> String:
return str(get_slot_plan(day, slot_id).get("forced_scene", ""))
## Liefert den Ort, an dem der Tag endet: laut Fahrplan Imogens Zimmer an
## Imogen-Abenden — aber erst, wenn imogen_nights_active gesetzt ist
## (bis dahin bleibt der Schlafsaal das Tagesende, damit nichts blockiert).
func get_day_end_location(day: int) -> String:
var location := str(get_day_plan(day).get("day_end_location", "dormitory"))
if location == "imogen_room" and not bool(GameState.get_story_flag(FLAG_IMOGEN_NIGHTS, false)):
return "dormitory"
return location
## Liefert Wrens Vertrauen (0–100, Start 50).
func get_wren_trust() -> int:
return int(GameState.get_story_flag(FLAG_WREN_TRUST, WREN_TRUST_START))
## Hebt oder senkt Wrens Vertrauen (Schutzentscheidungen, Eskorte).
func adjust_wren_trust(amount: int) -> void:
_set_meter(FLAG_WREN_TRUST, clampi(get_wren_trust() + amount, 0, 100))
## Liefert Imogens Offenheit (0–100, Start 60 — sinkt mit jedem
## verschwiegenen Geheimnis).
func get_imogen_openness() -> int:
return int(GameState.get_story_flag(FLAG_IMOGEN_OPENNESS, IMOGEN_OPENNESS_START))
## Hebt oder senkt Imogens Offenheit.
func adjust_imogen_openness(amount: int) -> void:
_set_meter(FLAG_IMOGEN_OPENNESS, clampi(get_imogen_openness() + amount, 0, 100))
## Liefert Cassians Eskalationsstufe (0–3).
func get_cassian_escalation() -> int:
return int(GameState.get_story_flag(FLAG_CASSIAN_ESCALATION, 0))
## Hebt Cassians Eskalationsstufe um eins (gedeckelt bei 3).
func escalate_cassian() -> void:
_set_meter(FLAG_CASSIAN_ESCALATION, clampi(get_cassian_escalation() + 1, 0, CASSIAN_ESCALATION_MAX))
## Liefert den Ausgang des Tag-9-Hinterhalts ("none"/"heart"/"blade").
func get_cassian_outcome() -> String:
return str(GameState.get_story_flag(FLAG_CASSIAN_OUTCOME, "none"))
## Setzt den Ausgang des Tag-9-Hinterhalts; unbekannte Werte werden mit
## Warnung ignoriert. Der Ausgang fließt später als Daumen ins Dreschen.
func set_cassian_outcome(outcome: String) -> void:
if not CASSIAN_OUTCOMES.has(outcome):
push_warning("Unbekannter Cassian-Ausgang: %s" % outcome)
return
GameState.set_story_flag(FLAG_CASSIAN_OUTCOME, outcome)
## Schreibt einen Messwert als Story-Flag und meldet die Änderung.
func _set_meter(flag_name: String, value: int) -> void:
GameState.set_story_flag(flag_name, value)
story_meter_changed.emit(flag_name, value)
## Liefert den aktuellen Gauntlet-Beat ("none", wenn noch keiner erreicht).
func get_gauntlet_beat() -> String:
return str(GameState.get_story_flag(FLAG_GAUNTLET_BEAT, "none"))
## Gibt zurück, ob die Kette den angegebenen Beat erreicht oder
## überschritten hat.
func has_reached_beat(beat: String) -> bool:
return GAUNTLET_BEATS.find(get_gauntlet_beat()) >= GAUNTLET_BEATS.find(beat)
## Setzt das Wahrheit-3-Flag: Die Drachen wählen Gezeichnete bewusst —
## Wiedererkennen statt Zufall (STORY.md Abschnitt 3, erfahrbar beim
## Dreschen).
func reveal_truth_3() -> void:
GameState.set_story_flag(FLAG_TRUTH_3, true)
## Gibt zurück, ob Wahrheit 3 bereits enthüllt wurde.
func has_truth_3() -> bool:
return bool(GameState.get_story_flag(FLAG_TRUTH_3, false))
## Rückt auf einen späteren Beat der Kette vor; Rückwärts-Sprünge und
## unbekannte Beats werden ignoriert (mit Warnung).
func advance_gauntlet_beat(new_beat: String) -> void:
var new_index := GAUNTLET_BEATS.find(new_beat)
if new_index < 0:
push_warning("Unbekannter Gauntlet-Beat: %s" % new_beat)
return
if new_index <= GAUNTLET_BEATS.find(get_gauntlet_beat()):
return
GameState.set_story_flag(FLAG_GAUNTLET_BEAT, new_beat)
gauntlet_beat_changed.emit(new_beat)