windgeschworen/scripts/autoloads/dialogue_system.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

289 lines
12 KiB
GDScript

extends Node
## Daten-getriebenes Dialog-System (Autoload, SPEC.md Abschnitte 6 und 8).
##
## Spielt verzweigte Dialogbäume aus JSON-Dateien unter data/dialogue ab.
## Jede Zeile erscheint gut lesbar in der Dialog-Box am unteren Bildrand
## (dialogue_box.tscn, inklusive Antwortauswahl) und zusätzlich als
## Sprechblase über dem Kopf des Sprechers (Kind-Node "SpeechBubble");
## die gewählte Antwort läuft über Tyrveils eigene Blase. Options-Tags
## verschieben die Klinge-↔-Herz-Achse (blade_heart) und Beziehungswerte
## (relationship: NPC-ID -> Delta) — aber nur beim ERSTEN Durchlauf eines
## Dialogs: Abgeschlossene Dialoge merkt sich GameState.completed_dialogues
## (dort statt im StorySystem, weil nur GameState bereits gespeichert und
## geladen wird und das Flag Save/Load überleben muss). Wiederholtes
## Ansprechen spielt den Text erneut ab, ohne Werte zu verschieben.
## Die Actions cancel und dialogue_abort (X) brechen einen laufenden
## Dialog ab; Tyrveil sagt dem Gegenüber dabei eine zufällig gewählte
## Zeile aus dem abort_lines-Array der Dialog-Datei an (Fallback:
## abort_line bzw. Standard) — so klingt der Abschied pro Charakter
## unterschiedlich. Dialoge mit "can_abort": false (z. B. der
## Wren-Moment am Viadukt) sind nicht abbrechbar: Der Spieler muss eine
## Option wählen, bevor die Szene fortschreitet. Options-Tag story_flag
## (Flag-Name -> Wert) schreibt Story-Flags in den GameState (z. B. WIE
## Wren gerettet wurde). Abgebrochene Dialoge gelten nur dann als geführt, wenn in diesem
## Durchlauf bereits Options-Effekte angewendet wurden — so bleibt der
## Erst-Durchlauf-Effekt erhalten, ohne dass Abbrechen zum Werte-Farming
## taugt. dialogue_started/dialogue_finished erlauben es, Spielerbewegung
## und UI während des Dialogs zu sperren.
signal dialogue_started(dialogue_id: String)
signal dialogue_finished(dialogue_id: String)
const BOX_SCENE := preload("res://scenes/ui/dialogue_box.tscn")
const PLAYER_SPEAKER_ID := "player"
const FALLBACK_LINE_SECONDS := 2.5
const DEFAULT_ABORT_LINE := "Nicht jetzt. Wir reden später weiter."
var is_dialogue_active := false
var is_abort_allowed := true
var _speakers: Dictionary = {}
var _speaker_names: Dictionary = {}
var _is_effect_pass := true
var _is_abort_requested := false
var _is_skip_requested := false
var _has_applied_effects := false
var _abort_lines: Array = [DEFAULT_ABORT_LINE]
var _box: CanvasLayer
## Startet einen Dialog aus einer JSON-Datei. speakers bildet Sprecher-IDs
## aus den Dialog-Knoten auf Szenen-Nodes mit SpeechBubble-Kind ab; der
## Spieler läuft unter der ID "player". Läuft bereits ein Dialog, passiert
## nichts.
func start_dialogue(dialogue_path: String, speakers: Dictionary) -> void:
if is_dialogue_active:
return
var data := _load_dialogue(dialogue_path)
if data.is_empty():
return
var dialogue_id := str(data["id"])
_speakers = speakers
_speaker_names = data.get("speakers", {})
_is_effect_pass = not GameState.has_completed_dialogue(dialogue_id)
_is_abort_requested = false
_is_skip_requested = false
_has_applied_effects = false
_abort_lines = data.get("abort_lines", [])
if _abort_lines.is_empty():
_abort_lines = [str(data.get("abort_line", DEFAULT_ABORT_LINE))]
is_abort_allowed = bool(data.get("can_abort", true))
is_dialogue_active = true
dialogue_started.emit(dialogue_id)
_run_dialogue(data)
## Merkt Abbruch- (cancel/dialogue_abort) und Skip-Wünsche
## (confirm/interact) während laufender Dialog-Zeilen vor; offene
## Antwortauswahlen behandelt die Dialog-Box selbst. Skippen springt
## Zeile für Zeile bis zur nächsten Auswahl und funktioniert auch in
## nicht abbrechbaren Dialogen.
func _unhandled_input(event: InputEvent) -> void:
if not is_dialogue_active:
return
if _box != null and _box.has_open_options():
return
if event.is_action_pressed("confirm") or event.is_action_pressed("interact"):
_is_skip_requested = true
return
if not is_abort_allowed:
return
if event.is_action_pressed("cancel") or event.is_action_pressed("dialogue_abort"):
_is_abort_requested = true
## Gibt zurück, ob der Node Sprecher des gerade laufenden Dialogs ist
## (z. B. für Wander-KI-Pause und Ambient-Abbruch).
func is_speaker(node: Node) -> bool:
return is_dialogue_active and _speakers.values().has(node)
## Liest und validiert eine Dialog-Datei; leeres Dictionary bei Fehlern.
func _load_dialogue(dialogue_path: String) -> Dictionary:
var file := FileAccess.open(dialogue_path, FileAccess.READ)
if file == null:
push_error("Dialog-Datei nicht lesbar: %s (%s)" % [dialogue_path, error_string(FileAccess.get_open_error())])
return {}
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if not (parsed is Dictionary) or not parsed.has("id") or not parsed.has("start") or not (parsed.get("nodes") is Dictionary):
push_error("Dialog-Datei ist kein gültiger Dialogbaum: %s" % dialogue_path)
return {}
return parsed
## Spielt den Dialogbaum als Coroutine ab: Zeilen über Box und
## Sprechblasen, Entscheidungen über die Auswahl in der Box, Effekte über
## die Options-Tags des ersten Durchlaufs.
func _run_dialogue(data: Dictionary) -> void:
var nodes: Dictionary = data["nodes"]
var node_id := str(data["start"])
while node_id != "" and nodes.has(node_id) and not _is_abort_requested:
var node: Dictionary = nodes[node_id]
var options: Array = node.get("options", [])
if options.is_empty():
node_id = await _play_line(node)
else:
node_id = await _play_choice(node, options)
var was_aborted := _is_abort_requested
if was_aborted:
await _play_abort_line()
_end_dialogue(str(data["id"]), was_aborted)
## Liefert den anzuzeigenden Text eines Knotens: Standard ist "text"
## (Fade-to-Black-Variante); trägt der Knoten ein optionales Feld
## "explicit_text" UND ist der Mature-Toggle aktiv, wird stattdessen die
## explizite Variante gezeigt (Romantik-Weiche, SPEC Abschnitt 6 — die
## expliziten Texte pflegt ausschließlich der Nutzer in den
## Dialog-Dateien, dieses Projekt liefert nur das Format).
func _node_text(node: Dictionary) -> String:
if MatureContentGate.is_explicit_enabled and node.has("explicit_text"):
return str(node["explicit_text"])
return str(node.get("text", ""))
## Zeigt eine Zeile ohne Optionen in Box und Sprechblase; die Blase (oder
## ein Fallback-Timer) bestimmt die Anzeigedauer. Liefert die ID des
## Folge-Knotens.
func _play_line(node: Dictionary) -> String:
var speaker_id := str(node.get("speaker", ""))
var text := _node_text(node)
_get_box().show_line(_display_name(speaker_id), text)
var bubble := _bubble_for(speaker_id)
if bubble != null:
bubble.show_line(text)
await _wait_for_line(bubble)
return _next_id(node)
## Wartet das Ende einer Zeile ab (Sprechblasen-Dauer oder Fallback-Timer)
## und bricht früh ab, sobald ein Dialog-Abbruch oder ein Zeilen-Skip
## (confirm/interact) angefordert wurde.
func _wait_for_line(bubble: Node) -> void:
_is_skip_requested = false
if bubble != null:
while bubble.visible and not _is_abort_requested and not _is_skip_requested:
await get_tree().process_frame
if _is_abort_requested or _is_skip_requested:
bubble.hide_bubble()
else:
var timer := get_tree().create_timer(FALLBACK_LINE_SECONDS)
while timer.time_left > 0.0 and not _is_abort_requested and not _is_skip_requested:
await get_tree().process_frame
_is_skip_requested = false
## Zeigt eine Zeile mit Antwortoptionen in Box (mit Auswahl) und
## Sprechblase (sticky), wendet beim ersten Durchlauf die Tags der
## gewählten Option an, spielt die Antwort über Tyrveils Blase und liefert
## die ID des Folge-Knotens.
func _play_choice(node: Dictionary, options: Array) -> String:
var speaker_id := str(node.get("speaker", ""))
var text := _node_text(node)
_get_box().show_line(_display_name(speaker_id), text)
var bubble := _bubble_for(speaker_id)
if bubble != null:
bubble.show_line(text, true)
var option_texts: Array[String] = []
for option in options:
option_texts.append(str(option.get("text", "")))
var index: int = await _get_box().choose(option_texts)
if bubble != null:
bubble.hide_bubble()
if index < 0:
_is_abort_requested = true
return ""
var option: Dictionary = options[clampi(index, 0, options.size() - 1)]
_apply_option_effects(option)
var answer := str(option.get("text", ""))
_get_box().show_line(_display_name(PLAYER_SPEAKER_ID), answer)
var player_bubble := _bubble_for(PLAYER_SPEAKER_ID)
if player_bubble != null:
player_bubble.show_line(answer)
await _wait_for_line(player_bubble)
return _next_id(option)
## Wendet die Effekt-Tags einer Option an — nur beim ersten Durchlauf des
## Dialogs: blade_heart verschiebt die Klinge-↔-Herz-Achse, relationship
## verschiebt Beziehungswerte pro NPC.
func _apply_option_effects(option: Dictionary) -> void:
if not _is_effect_pass:
return
var tone_shift := int(option.get("blade_heart", 0))
if tone_shift != 0:
GameState.shift_blade_heart_tone(tone_shift)
_has_applied_effects = true
var relationship_shifts: Dictionary = option.get("relationship", {})
for npc_id in relationship_shifts:
RelationshipSystem.adjust_relationship(str(npc_id), int(relationship_shifts[npc_id]))
_has_applied_effects = true
var flag_changes: Dictionary = option.get("story_flag", {})
for flag_name in flag_changes:
GameState.set_story_flag(str(flag_name), flag_changes[flag_name])
_has_applied_effects = true
var standing_shifts: Dictionary = option.get("faction_standing", {})
for faction_id in standing_shifts:
FactionSystem.adjust_standing(str(faction_id), int(standing_shifts[faction_id]))
_has_applied_effects = true
## Spielt eine zufällig gewählte Abbruch-Zeile Tyrveils, damit der
## Abbruch dem Gegenüber angesagt wird, bevor der Dialog endet.
func _play_abort_line() -> void:
_is_abort_requested = false
var line := str(_abort_lines.pick_random())
_get_box().show_line(_display_name(PLAYER_SPEAKER_ID), line)
var player_bubble := _bubble_for(PLAYER_SPEAKER_ID)
if player_bubble != null:
player_bubble.show_line(line)
await _wait_for_line(player_bubble)
## Beendet den Dialog und gibt Box und Sprecher-Referenzen frei. Als
## geführt markiert wird er bei regulärem Ende immer, bei Abbruch nur,
## wenn in diesem Durchlauf bereits Effekte angewendet wurden (verhindert
## Werte-Farming, lässt aber den Erst-Durchlauf-Effekt bestehen).
func _end_dialogue(dialogue_id: String, was_aborted := false) -> void:
if not was_aborted or _has_applied_effects:
GameState.mark_dialogue_completed(dialogue_id)
_get_box().hide_box()
is_dialogue_active = false
_speakers.clear()
_speaker_names.clear()
dialogue_finished.emit(dialogue_id)
## Liefert die Sprechblase (Kind "SpeechBubble") eines Sprechers, null mit
## Warnung, wenn Sprecher oder Blase fehlen.
func _bubble_for(speaker_id: String) -> Node:
var speaker: Node = _speakers.get(speaker_id)
if speaker == null:
push_warning("Kein Sprecher-Node für ID '%s' registriert." % speaker_id)
return null
var bubble := speaker.get_node_or_null("SpeechBubble")
if bubble == null:
push_warning("Sprecher '%s' hat keine SpeechBubble." % speaker_id)
return bubble
## Liefert den Anzeigenamen eines Sprechers aus der speakers-Map der
## Dialog-Datei, sonst die großgeschriebene Sprecher-ID.
func _display_name(speaker_id: String) -> String:
return str(_speaker_names.get(speaker_id, speaker_id.capitalize()))
## Liefert die ID des Folge-Knotens aus einem Knoten oder einer Option;
## leerer String beendet den Dialog (auch bei JSON-null).
func _next_id(source: Dictionary) -> String:
var next: Variant = source.get("next")
return next if next is String else ""
## Instanziiert die Dialog-Box beim ersten Bedarf.
func _get_box() -> CanvasLayer:
if _box == null:
_box = BOX_SCENE.instantiate()
add_child(_box)
return _box