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. 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 _speakers: Dictionary = {} var _speaker_names: Dictionary = {} var _is_effect_pass := true var _is_abort_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 _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_dialogue_active = true dialogue_started.emit(dialogue_id) _run_dialogue(data) ## Merkt einen Abbruch-Wunsch (cancel) während laufender Dialog-Zeilen ## vor; offene Antwortauswahlen behandelt die Dialog-Box selbst. 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("cancel") or event.is_action_pressed("dialogue_abort"): _is_abort_requested = true ## 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) ## 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 := str(node.get("text", "")) _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 angefordert wurde. func _wait_for_line(bubble: Node) -> void: if bubble != null: while bubble.visible and not _is_abort_requested: await get_tree().process_frame if _is_abort_requested: bubble.hide_bubble() return var timer := get_tree().create_timer(FALLBACK_LINE_SECONDS) while timer.time_left > 0.0 and not _is_abort_requested: await get_tree().process_frame ## 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 := str(node.get("text", "")) _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 ## 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