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>
This commit is contained in:
danny 2026-07-11 18:45:34 +02:00
parent 1a2c1be65d
commit 7830c0b67c
15 changed files with 474 additions and 43 deletions

View file

@ -1,21 +1,40 @@
extends Node
## Story-Beats und Story-Flags (Autoload, SPEC.md Abschnitt 8).
## Story-Beats, Story-Flags und der 10-Tage-Fahrplan (Autoload, SPEC.md
## Abschnitt 8; v1-Ausbau Phase 1 nach STORY.md Abschnitt 5).
##
## Erste echte Beat-Logik (Phase 4c): der Gauntlet-Klimax aus STORY.md
## Abschnitt 5 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, wie der Verlust,
## den er erzählt. Beat-Bedeutung: gauntlet_started (Lauf betreten),
## maren_intervention (Maren geht dazwischen), maren_death (der Einsturz
## trifft sie — fix, unabhängig von Permadeath), truth_1_revealed /
## truth_2_revealed (ihre letzten Worte), gauntlet_completed (nach der
## Trauer-Entscheidung).
## 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",
@ -26,6 +45,110 @@ const GAUNTLET_BEATS: Array[String] = [
"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: