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:

View file

@ -1,22 +1,33 @@
extends Node
## Tageszyklus (Autoload, SPEC.md Abschnitte 6 und 8).
## Tageszyklus (Autoload, SPEC.md Abschnitte 6 und 8; v1-Ausbau Phase 1:
## 10-Tage-Zyklus nach STORY.md Abschnitt 5).
##
## Verwaltet die Tages-Slots Vormittag/Nachmittag/Abend und den
## Tageszähler. advance_slot() rückt bis zum Abend vor; den Tag beendet
## laut SPEC ausschließlich der Schlafsaal über end_day(), das auf den
## Vormittag des Folgetags springt. Zustand ist in Phase 1b bewusst nur
## In-Memory — die Save/Load-Anbindung folgt, sobald der Zustand feststeht.
## Tageszähler über die zehn spielbaren Tage von Akt 1. advance_slot()
## rückt bis zum Abend vor; den Tag beendet ausschließlich der im
## Fahrplan (StorySystem, data/story/days/) hinterlegte Ort über
## try_end_day(): regulär der Schlafsaal, ab dem Story-Flag
## imogen_nights_active an Imogen-Abenden ihr Zimmer. Das Ende von
## Tag 10 beendet Akt 1 (act_one_completed, Schnitt in den Wendepunkt) —
## der Tageszähler läuft nie über MAX_DAYS hinaus.
signal slot_changed(new_slot: DaySlot)
signal day_ended(new_day: int)
signal act_one_completed
enum DaySlot { MORNING, AFTERNOON, EVENING }
const MAX_DAYS := 10
const SLOT_NAMES := {
DaySlot.MORNING: "Vormittag",
DaySlot.AFTERNOON: "Nachmittag",
DaySlot.EVENING: "Abend",
}
const SLOT_IDS := {
DaySlot.MORNING: "morning",
DaySlot.AFTERNOON: "afternoon",
DaySlot.EVENING: "evening",
}
var current_slot := DaySlot.MORNING
var day_count := 1
@ -25,7 +36,7 @@ var is_current_slot_used := false
## Verbraucht den aktuellen Tages-Slot für eine Aktivität (Unterricht
## etc.): Vormittag/Nachmittag rücken direkt auf den nächsten Slot vor,
## der Abend wird als verbraucht markiert — danach ist bis zum Schlafsaal
## der Abend wird als verbraucht markiert — danach ist bis zum Tagesende
## keine Aktivität mehr möglich. Liefert false, wenn der Slot schon
## verbraucht ist.
func try_spend_slot() -> bool:
@ -46,7 +57,7 @@ func reset() -> void:
## Rückt auf den nächsten Tages-Slot vor. Vom Abend aus passiert nichts —
## den Tag beendet ausschließlich der Schlafsaal (end_day()).
## den Tag beendet ausschließlich der Tagesende-Ort (try_end_day()).
func advance_slot() -> void:
match current_slot:
DaySlot.MORNING:
@ -54,21 +65,44 @@ func advance_slot() -> void:
DaySlot.AFTERNOON:
_change_slot(DaySlot.EVENING)
DaySlot.EVENING:
push_warning("advance_slot() am Abend ignoriert — Tag endet nur im Schlafsaal.")
push_warning("advance_slot() am Abend ignoriert — Tag endet nur am Tagesende-Ort.")
## Beendet den Tag, wenn der angegebene Ort laut Fahrplan der heutige
## Tagesende-Ort ist (Schlafsaal bzw. an Imogen-Abenden ihr Zimmer).
## Liefert false, wenn der Tag hier nicht enden kann.
func try_end_day(location_id: String) -> bool:
if location_id != get_day_end_location():
return false
end_day()
return true
## Liefert den Ort, an dem der aktuelle Tag laut Fahrplan endet
## ("dormitory" oder "imogen_room").
func get_day_end_location() -> String:
return StorySystem.get_day_end_location(day_count)
## Stellt Tag, Slot und Slot-Verbrauch aus einem Spielstand wieder her
## (aufgerufen von GameState.apply_save_dict, damit der Tageszyklus im
## selben Spielstand mitreist). Meldet den Slot über slot_changed.
func apply_save_state(saved_day: int, saved_slot: int, is_used: bool) -> void:
day_count = maxi(1, saved_day)
day_count = clampi(saved_day, 1, MAX_DAYS)
_change_slot(clampi(saved_slot, DaySlot.MORNING, DaySlot.EVENING) as DaySlot)
is_current_slot_used = is_used
## Beendet den Tag über den Schlafsaal-Trigger: erhöht den Tageszähler und
## springt zurück auf den Vormittag.
## Beendet den Tag: erhöht den Tageszähler und springt zurück auf den
## Vormittag. Das Ende von Tag MAX_DAYS beendet stattdessen Akt 1
## (act_one_completed + persistentes Story-Flag) — der Zähler bleibt
## stehen, die Wendepunkt-Szene übernimmt.
func end_day() -> void:
if day_count >= MAX_DAYS:
GameState.set_story_flag("act_one_completed", true)
act_one_completed.emit()
_change_slot(DaySlot.MORNING)
return
day_count += 1
day_ended.emit(day_count)
_change_slot(DaySlot.MORNING)
@ -79,6 +113,12 @@ func get_slot_name() -> String:
return SLOT_NAMES[current_slot]
## Liefert die Fahrplan-Kennung des aktuellen Slots ("morning"/
## "afternoon"/"evening") für den daten-getriebenen Tagesplan.
func get_slot_id() -> String:
return SLOT_IDS[current_slot]
## Setzt den Slot, gibt den Aktivitäts-Verbrauch frei und meldet echte
## Wechsel über slot_changed.
func _change_slot(new_slot: DaySlot) -> void:

View file

@ -1,10 +1,15 @@
extends Area3D
## Schlafsaal-Trigger (Phase 1b, SPEC.md Abschnitt 6).
## Tagesende-Trigger (Phase 1b, SPEC.md Abschnitt 6; v1-Ausbau Phase 1).
##
## Beendet beim Betreten durch den Spieler den Tag über
## TimeSystem.end_day(): Tageszähler steigt, der Slot springt zurück auf
## den Vormittag. Rückmeldung vorerst über die Konsole und das
## Debug-Overlay; eine Schlaf-Sequenz mit UI folgt in einer späteren Phase.
## TimeSystem.try_end_day(location_id): Der Fahrplan (StorySystem)
## bestimmt, wo der Tag enden darf — regulär der Schlafsaal, an
## Imogen-Abenden (ab Story-Flag imogen_nights_active) ihr Zimmer.
## Endet der Tag hier nicht, passiert nichts außer einem Hinweis.
## Rückmeldung vorerst über die Konsole und das Debug-Overlay; eine
## Schlaf-Sequenz mit UI folgt in einer späteren Phase.
@export var location_id := "dormitory"
## Verbindet das Betreten-Signal des Triggers.
@ -13,11 +18,13 @@ func _ready() -> void:
## Beendet den Tag und speichert regulär, sobald der Spieler den
## Schlafbereich betritt — der Schlafsaal ist der reguläre Speicherpunkt
## Schlafbereich betritt — das Tagesende ist der reguläre Speicherpunkt
## des Spiels (unabhängig vom Debug-Modus).
func _on_body_entered(body: Node3D) -> void:
if not body.is_in_group("player"):
return
TimeSystem.end_day()
if not TimeSystem.try_end_day(location_id):
print("Der Tag endet heute nicht hier (%s) — Tagesende: %s." % [location_id, TimeSystem.get_day_end_location()])
return
SaveSystem.save_game()
print("Geschlafen und gespeichert — Tag %d, %s." % [TimeSystem.day_count, TimeSystem.get_slot_name()])