windgeschworen/scripts/ui/main_menu.gd
danny 01f50f3107 Phase 6a: Mature-Gate mit 18+-Screen, Explizit-Toggle, Debug-Flag
- MatureContentGate: 18+-Bestaetigung und Explizit-Toggle persistent in
  user://settings.json (installations- statt durchlaufbezogen, daher
  getrennt vom Spielstand)
- 18+-Screen mit Content-Warnung als Overlay ueber dem Hauptmenue beim
  allerersten Start (kein zusaetzlicher Szenenschritt); fokus-navigierbar
  nach dem confirm-Muster, Beenden-Ausweg; erscheint nach Bestaetigung
  nie wieder
- Options-Toggle Explizite Inhalte im Hauptmenue (Default AUS, Muster wie
  Permadeath-Toggle)
- Romantik-Weiche als dokumentiertes Format: optionales Feld
  explicit_text in Dialog-Knoten, vom DialogueSystem nur bei aktivem
  Toggle genutzt (_node_text); Standardtext bleibt die
  Fade-to-Black-Variante, explizite Texte pflegt laut SPEC ausschliesslich
  der Nutzer - keine Inhalte angelegt
- Debug-Aufraeumen: GameState.is_debug_mode (Umschalten direkt im Skript
  dokumentiert, true beim Testen / false im Release) schaltet Tab-Save
  (Hub + Testszene) und F9/F10; Schlafsaal speichert jetzt regulaer beim
  Schlafen (unabhaengig vom Debug-Modus), Dreschen-Autosave unveraendert
- Headless verifiziert (29 Checks): Weiche, Gate-Erststart/-Persistenz,
  Toggle-Roundtrip, Untertitel-Verhalten, Debug AN/AUS fuer Tab und
  F9/F10, regulaeres Schlafsaal-Speichern

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-07 06:23:28 +02:00

113 lines
4.6 KiB
GDScript

extends Control
## Minimalistisches Hauptmenü (Phase 1a, SPEC.md Phasen-Roadmap).
##
## 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")
@onready var _start_button: Button = $CenterContainer/VBoxContainer/StartButton
@onready var _continue_button: Button = $CenterContainer/VBoxContainer/ContinueButton
@onready var _permadeath_button: Button = $CenterContainer/VBoxContainer/PermadeathButton
@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)
_permadeath_button.pressed.connect(_on_permadeath_pressed)
_explicit_button.pressed.connect(_on_explicit_pressed)
_quit_button.pressed.connect(_on_quit_pressed)
_update_permadeath_text()
_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 den Reiterquadranten.
func _on_continue_pressed() -> void:
if SaveSystem.load_game():
get_tree().change_scene_to_file(CONTINUE_SCENE)
## Schaltet Permadeath um (SPEC Abschnitt 6: Toggle, Default AN). Die
## Wahl übersteht GameState.reset() und wird beim Speichern im Spielstand
## abgelegt; Fortsetzen stellt den gespeicherten Zustand wieder her.
func _on_permadeath_pressed() -> void:
GameState.is_permadeath_enabled = not GameState.is_permadeath_enabled
_update_permadeath_text()
## 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 Toggle-Text synchron zum GameState.
func _update_permadeath_text() -> void:
_permadeath_button.text = "Permadeath: %s" % ("AN" if GameState.is_permadeath_enabled else "AUS")
## 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")