CR 50: Debug-Direkteinstieg in Akt 2 mit gesetzten Akt-1-Flags

Zusaetzlicher Startmenue-Button, nur im Debug-Build sichtbar
(OS.is_debug_build), der den Zustand am Ende von Akt 1 aufsetzt und direkt
in den Akt-2-Kapitel-Runner springt. Spart ab sofort das komplette
Akt-1-Durchspielen bei jedem Akt-2-Test.

Der Zustand wird NICHT als Flag-Liste erfunden, sondern ueber dieselben
Systemaufrufe hergestellt, die der regulaere Weg benutzt — DragonBondSystem,
SignetSystem, StorySystem, genau wie dragon_vale.gd::_run_bonding. Damit
driftet der Teststart nicht auseinander, wenn sich Akt 1 aendert. Was gesetzt
wird, steht in data/story/akt1_abschluss.json und ist ohne Codeaenderung
anpassbar. Einzige bewusste Abweichung: Der Bindungswurf ist erzwungen
angenommen — im Spiel kann Smaladhs Pruefung toedlich ausgehen, beim
Testeinstieg waere das sinnlos.

Spielstand-Schutz: Der Runner speichert am Ende seines Durchlaufs, und auch
die Bindung ruft save_game(). Ohne Gegenmassnahme haette der kuenstliche
Teststart den echten Spielstand ueberschrieben — CR 50 schliesst das
ausdruecklich aus. SaveSystem bekommt dafuer eine Sitzungs-Speichersperre
(block_saving), die der Direkteinstieg setzt; nicht persistent.

Verifikation, Sonde 23/23 plus 4/4 Integration:
- Akt-1-Zustand steht: act_one_completed, praesentation_done, Smaladh
  gebunden, Gauntlet bis gauntlet_completed, Wahrheit 3, Tag 10.
- CR 35 bleibt gewahrt: Die Erstkraft ist gewuerfelt, aber NICHT enthuellt,
  und steht nicht im bound_dragon-Record — kein vorzeitiger Lexicon-Eintrag.
- Kontrolle Speichersperre: gesperrt liefert save_game() false und laesst die
  Datei unangetastet, ohne Sperre schreibt derselbe Aufruf.
- Button-Sichtbarkeit folgt OS.is_debug_build(); Neues Spiel und Fortsetzen
  unveraendert, nach GameState.reset() sind die Akt-1-Flags wieder weg.
- Integration: Der Einstieg landet im Auftakt-Kapitel, erste gespielte Szene
  ist akt2_auftakt_staffel.

Die Sonde sichert den echten Spielstand vor dem Test und spielt ihn zurueck.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-09-12 12:51:05 +02:00
parent b423531bb8
commit 89d33e0730
6 changed files with 128 additions and 0 deletions

View file

@ -10,11 +10,21 @@ extends Node
## einen Permadeath/Ironman-Modus gibt es nicht mehr.
const SAVE_PATH := "user://savegame.json"
var is_saving_blocked := false
const NEW_GAME_SCENE := "res://scenes/viaduct/viaduct.tscn"
const FALLBACK_SCENE := "res://scenes/hub/rider_quadrant.tscn"
## Gibt zurück, ob ein Spielstand existiert.
## Sperrt oder entsperrt das Speichern fuer diese Sitzung (CR 50). Der
## Debug-Direkteinstieg ins Akt-2-Testing setzt einen kuenstlichen Zustand
## auf; ohne diese Sperre wuerde der erste Auto-Save den echten Spielstand
## des Spielers ueberschreiben. Nicht persistent — gilt nur bis zum Beenden.
func block_saving(is_blocked: bool) -> void:
is_saving_blocked = is_blocked
func has_save() -> bool:
return FileAccess.file_exists(SAVE_PATH)
@ -22,6 +32,8 @@ func has_save() -> bool:
## Schreibt den kompletten GameState als JSON nach SAVE_PATH.
## Liefert true bei Erfolg, sonst false mit Fehlermeldung im Log.
func save_game() -> bool:
if is_saving_blocked:
return false
var file := FileAccess.open(SAVE_PATH, FileAccess.WRITE)
if file == null:
push_error("Spielstand konnte nicht geschrieben werden: %s" % error_string(FileAccess.get_open_error()))

View file

@ -0,0 +1,77 @@
class_name Akt1Abschluss
extends RefCounted
## Stellt den Zustand am Ende von Akt 1 her (CR 50).
##
## Gebraucht fuer den Direkteinstieg ins Akt-2-Testing: Jede Akt-2-Aenderung
## von Hand zu pruefen hiesse sonst, erst Akt 1 komplett durchzuspielen.
##
## Bildet den **echten** Uebergang nach statt eine Flag-Liste zu erfinden —
## es laufen dieselben Systemaufrufe wie auf dem regulaeren Weg
## (`dragon_vale.gd::_run_bonding`, `StorySystem`, `SignetSystem`), damit der
## Startzustand nicht auseinanderdriftet, wenn sich Akt 1 aendert. Was genau
## gesetzt wird, steht in `data/story/akt1_abschluss.json` und ist damit ohne
## Codeaenderung anpassbar.
##
## Einzige bewusste Abweichung: Der Bindungswurf wird erzwungen angenommen
## (`roll_bond(true)`). Im Spiel kann Smaladhs Pruefung toedlich ausgehen —
## beim Testeinstieg waere das sinnlos.
const PFAD := "res://data/story/akt1_abschluss.json"
## Setzt GameState und Tageszyklus auf den Akt-1-Abschluss. Liefert false,
## wenn die Datei fehlt oder ungueltig ist — dann bleibt alles unveraendert.
static func anwenden() -> bool:
var daten := _laden()
if daten.is_empty():
return false
GameState.reset()
TimeSystem.reset()
var flags: Dictionary = daten.get("flags", {})
for flag_name in flags:
GameState.set_story_flag(str(flag_name), flags[flag_name])
var beat := str(daten.get("gauntlet_beat", ""))
if not beat.is_empty():
StorySystem.advance_gauntlet_beat(beat)
var ausgang := str(daten.get("cassian_ausgang", ""))
if not ausgang.is_empty():
StorySystem.set_cassian_outcome(ausgang)
GameState.set_story_flag("cassian_choice", ausgang)
if bool(daten.get("wahrheit_3", false)):
StorySystem.reveal_truth_3()
if bool(daten.get("bindung", false)):
_binden()
var tag := int(daten.get("tag", 1))
if tag > 1:
TimeSystem.apply_save_state(tag, 0, false)
return true
## Bindet Smaladh genau so, wie es das Dreschen tut: fixer Record ohne die
## reinen Anzeigezeilen, still gewuerfelte Erstkraft (CR 35 — enthuellt wird
## sie erst in Akt 2 K2) und die geheime Zweitkraft.
static func _binden() -> void:
var ergebnis := DragonBondSystem.roll_bond(true)
if not bool(ergebnis.get("accepted", false)):
return
var record := ergebnis.duplicate()
record.erase("accepted")
record.erase("bond_line")
record.erase("reveal_line")
GameState.set_bound_dragon(record)
SignetSystem.grant_first_signet(str(ergebnis.get("signet_strength", "")))
SignetSystem.grant_second_signet()
## Liest die Zustandsbeschreibung; leeres Dictionary bei Fehlern.
static func _laden() -> Dictionary:
var datei := FileAccess.open(PFAD, FileAccess.READ)
if datei == null:
push_error("Akt-1-Abschluss nicht lesbar: %s" % PFAD)
return {}
var geparst: Variant = JSON.parse_string(datei.get_as_text())
datei.close()
if not (geparst is Dictionary):
push_error("Akt-1-Abschluss ist ungueltig: %s" % PFAD)
return {}
return geparst

View file

@ -0,0 +1 @@
uid://bfyvofjhnxvys

View file

@ -1,6 +1,9 @@
extends Control
## Minimalistisches Hauptmenü (Phase 1a, SPEC.md Phasen-Roadmap).
##
## Im Debug-Build gibt es zusaetzlich einen Direkteinstieg in Akt 2 mit
## gesetzten Akt-1-Flags (CR 50) — im Release ist der Button unsichtbar.
##
## Start setzt den GameState auf ein neues Spiel zurück und lädt die
## Greybox-Testszene. Fortsetzen ist nur sichtbar, wenn ein Spielstand
## existiert, und lädt ihn über SaveSystem. Beenden schließt das Spiel.
@ -13,9 +16,11 @@ extends Control
const NEW_GAME_SCENE := "res://scenes/viaduct/viaduct.tscn"
const CONTINUE_SCENE := "res://scenes/hub/rider_quadrant.tscn"
const MATURE_GATE_SCENE := preload("res://scenes/ui/mature_gate.tscn")
const AKT2_DEBUG_SCENE := "res://scenes/akt2/akt2_runner.tscn"
@onready var _start_button: Button = $CenterContainer/VBoxContainer/StartButton
@onready var _continue_button: Button = $CenterContainer/VBoxContainer/ContinueButton
@onready var _akt2_debug_button: Button = $CenterContainer/VBoxContainer/Akt2DebugButton
@onready var _explicit_button: Button = $CenterContainer/VBoxContainer/ExplicitButton
@onready var _quit_button: Button = $CenterContainer/VBoxContainer/QuitButton
@ -27,6 +32,8 @@ func _ready() -> void:
_continue_button.visible = SaveSystem.has_save()
_start_button.pressed.connect(_on_start_pressed)
_continue_button.pressed.connect(_on_continue_pressed)
_akt2_debug_button.visible = OS.is_debug_build()
_akt2_debug_button.pressed.connect(_on_akt2_debug_pressed)
_explicit_button.pressed.connect(_on_explicit_pressed)
_quit_button.pressed.connect(_on_quit_pressed)
_update_explicit_text()
@ -86,6 +93,20 @@ func _on_continue_pressed() -> void:
get_tree().change_scene_to_file(target)
## Direkteinstieg ins Akt-2-Testing (CR 50, nur Debug-Build): setzt den
## Zustand am Ende von Akt 1 auf und springt in den Akt-2-Kapitel-Runner,
## der beim Auftakt-Kapitel beginnt. Das Speichern wird fuer die Sitzung
## gesperrt, damit dieser kuenstliche Zustand keinen echten Spielstand
## ueberschreibt — der Runner speichert am Ende seines Durchlaufs.
func _on_akt2_debug_pressed() -> void:
if not OS.is_debug_build():
return
if not Akt1Abschluss.anwenden():
return
SaveSystem.block_saving(true)
get_tree().change_scene_to_file(AKT2_DEBUG_SCENE)
## Beendet das Spiel.
func _on_quit_pressed() -> void:
get_tree().quit()