windgeschworen/scripts/ui/main_menu.gd
danny 89d33e0730 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>
2026-09-12 12:51:05 +02:00

124 lines
5.1 KiB
GDScript

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.
## Vollständig fokus-navigierbar mit Tastatur und Controller:
## Pfeiltasten/D-Pad/linker Stick bewegen den Fokus, die confirm-Action
## (Enter/Ⓐ/✕) aktiviert den fokussierten Button, cancel (Esc/Ⓑ/◯) springt
## auf den Beenden-Button. Die Aktivierung läuft explizit über die
## Input-Map-Action confirm und hängt nicht an Godots internem ui_accept.
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
## Gibt die Maus frei, blendet Fortsetzen je nach Save-Existenz ein,
## verbindet die Buttons und setzt den Start-Fokus.
func _ready() -> void:
Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
_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()
if not MatureContentGate.is_age_confirmed:
var gate := MATURE_GATE_SCENE.instantiate()
add_child(gate)
gate.confirmed.connect(func() -> void: _start_button.grab_focus())
return
_start_button.grab_focus.call_deferred()
## Aktiviert mit confirm den fokussierten Button und springt mit cancel auf
## den Beenden-Button.
func _unhandled_input(event: InputEvent) -> void:
if event.is_action_pressed("confirm"):
_handle_confirm(event)
elif event.is_action_pressed("cancel"):
_quit_button.grab_focus()
## Löst den fokussierten Button für confirm-Events aus, die Godots
## eingebautes ui_accept NICHT abdeckt (z. B. Controller-Ⓐ/✕). Events, die
## auch ui_accept matchen (Enter), verarbeitet der fokussierte Button
## bereits selbst — sie hier erneut auszulösen wäre eine Doppel-Aktivierung
## (per Input-Sonde verifiziert). Hat kein Control den Fokus, wird er
## stattdessen auf den Start-Button zurückgesetzt.
func _handle_confirm(event: InputEvent) -> void:
var focused := get_viewport().gui_get_focus_owner()
if focused == null:
_start_button.grab_focus()
return
if event.is_action("ui_accept"):
return
var button := focused as BaseButton
if button != null and not button.disabled:
button.pressed.emit()
## Startet ein neues Spiel mit frisch zurückgesetztem GameState und
## Tageszyklus direkt auf dem Viadukt — der Protagonist ist Tyrveil,
## eine Umbenennung gibt es bewusst nicht (Change Request).
func _on_start_pressed() -> void:
GameState.reset()
TimeSystem.reset()
get_tree().change_scene_to_file(NEW_GAME_SCENE)
## Lädt den Spielstand und wechselt bei Erfolg in die gespeicherte Szene
## (z. B. die Drachen nach dem Dreschen-Autosave); ältere Spielstände
## ohne Szenen-Eintrag fallen auf den Reiterquadranten zurück.
func _on_continue_pressed() -> void:
if not SaveSystem.load_game():
return
var target := GameState.saved_scene_path
if target.is_empty() or not ResourceLoader.exists(target):
target = CONTINUE_SCENE
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()
## Schaltet explizite Inhalte um (SPEC Abschnitt 6, Default AUS); die
## Wahl liegt persistent in user://settings.json (MatureContentGate).
func _on_explicit_pressed() -> void:
MatureContentGate.set_explicit_enabled(not MatureContentGate.is_explicit_enabled)
_update_explicit_text()
## Hält den Explizit-Toggle-Text synchron zum MatureContentGate.
func _update_explicit_text() -> void:
_explicit_button.text = "Explizite Inhalte: %s" % ("AN" if MatureContentGate.is_explicit_enabled else "AUS")