- dialogue_choices zu dialogue_box umgebaut: Panel am unteren Bildrand zeigt jede Dialog-Zeile mit Sprechernamen lesbar an, Antwortauswahl integriert; Sprechblasen bleiben als Ambiente (CHANGEREQUESTS_DONE.md) - DialogueSystem spiegelt jede Zeile in die Box, Anzeigenamen aus neuer speakers-Map der Dialog-Dateien (Fallback: grossgeschriebene ID) - Einmal-Effekt-Grundlage: GameState.completed_dialogues (gespeichert, Save/Load-fest), DialogueSystem wendet Options-Effekte nur beim ersten Durchlauf an - Doc-Updates des Users eingecheckt: TYRVEIL.md (Protagonisten-Akte), WELT.md (Buch-Kanon), ueberarbeitete STORY/CHARACTERS/SPEC, CHANGEREQUESTS-Workflow Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
184 lines
7 KiB
GDScript
184 lines
7 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.
|
|
## 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
|
|
|
|
var is_dialogue_active := false
|
|
|
|
var _speakers: Dictionary = {}
|
|
var _speaker_names: Dictionary = {}
|
|
var _is_effect_pass := true
|
|
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_dialogue_active = true
|
|
dialogue_started.emit(dialogue_id)
|
|
_run_dialogue(data)
|
|
|
|
|
|
## 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):
|
|
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)
|
|
_end_dialogue(str(data["id"]))
|
|
|
|
|
|
## 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 bubble.line_finished
|
|
else:
|
|
await get_tree().create_timer(FALLBACK_LINE_SECONDS).timeout
|
|
return _next_id(node)
|
|
|
|
|
|
## 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()
|
|
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 player_bubble.line_finished
|
|
else:
|
|
await get_tree().create_timer(FALLBACK_LINE_SECONDS).timeout
|
|
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)
|
|
var relationship_shifts: Dictionary = option.get("relationship", {})
|
|
for npc_id in relationship_shifts:
|
|
RelationshipSystem.adjust_relationship(str(npc_id), int(relationship_shifts[npc_id]))
|
|
|
|
|
|
## Beendet den Dialog, markiert ihn als geführt und gibt Box und
|
|
## Sprecher-Referenzen frei.
|
|
func _end_dialogue(dialogue_id: String) -> void:
|
|
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
|