CR: BG3-Chatbox fuer Dialoge + Doc-Updates (TYRVEIL.md, WELT.md)

- 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>
This commit is contained in:
danny 2026-07-05 00:34:06 +02:00
parent 9fd103e9ce
commit 0f4ab3d3eb
14 changed files with 624 additions and 200 deletions

View file

@ -2,24 +2,32 @@ extends Node
## Daten-getriebenes Dialog-System (Autoload, SPEC.md Abschnitte 6 und 8).
##
## Spielt verzweigte Dialogbäume aus JSON-Dateien unter data/dialogue ab.
## Sprecher-Zeilen erscheinen über der Sprechblase des jeweiligen Sprechers
## (Kind-Node "SpeechBubble"), die vom Spieler gewählte Antwort über seiner
## eigenen. Antwortoptionen laufen über die fokus-navigierbare Auswahl
## (dialogue_choices.tscn). Options-Tags verschieben die
## Klinge-↔-Herz-Achse (blade_heart) und Beziehungswerte (relationship:
## NPC-ID -> Delta). dialogue_started/dialogue_finished erlauben es,
## Spielerbewegung und UI während des Dialogs zu sperren.
## 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 CHOICES_SCENE := preload("res://scenes/ui/dialogue_choices.tscn")
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 _choices: CanvasLayer
var _speaker_names: Dictionary = {}
var _is_effect_pass := true
var _box: CanvasLayer
## Startet einen Dialog aus einer JSON-Datei. speakers bildet Sprecher-IDs
@ -32,9 +40,12 @@ func start_dialogue(dialogue_path: String, speakers: Dictionary) -> void:
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(str(data["id"]))
dialogue_started.emit(dialogue_id)
_run_dialogue(data)
@ -52,54 +63,74 @@ func _load_dialogue(dialogue_path: String) -> Dictionary:
return parsed
## Spielt den Dialogbaum als Coroutine ab: Zeilen über die Sprechblasen,
## Entscheidungen über die Antwortauswahl, Effekte über die Options-Tags.
## 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 bubble := _bubble_for(str(node.get("speaker", "")))
var options: Array = node.get("options", [])
if options.is_empty():
node_id = await _play_line(bubble, node)
node_id = await _play_line(node)
else:
node_id = await _play_choice(bubble, node, options)
node_id = await _play_choice(node, options)
_end_dialogue(str(data["id"]))
## Zeigt eine Zeile ohne Optionen und liefert die ID des Folge-Knotens.
func _play_line(bubble: Node, node: Dictionary) -> String:
## 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(str(node.get("text", "")))
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, wendet die Tags der gewählten
## Option an, spielt die Antwort über der Spieler-Sprechblase und liefert
## 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(bubble: Node, node: Dictionary, options: Array) -> String:
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(str(node.get("text", "")), true)
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_choices().choose(option_texts)
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(str(option.get("text", "")))
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: blade_heart verschiebt die
## Klinge-↔-Herz-Achse, relationship verschiebt Beziehungswerte pro NPC.
## 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)
@ -108,10 +139,14 @@ func _apply_option_effects(option: Dictionary) -> void:
RelationshipSystem.adjust_relationship(str(npc_id), int(relationship_shifts[npc_id]))
## Beendet den Dialog und gibt die Sprecher-Referenzen frei.
## 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)
@ -128,6 +163,12 @@ func _bubble_for(speaker_id: String) -> Node:
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:
@ -135,9 +176,9 @@ func _next_id(source: Dictionary) -> String:
return next if next is String else ""
## Instanziiert die Antwortauswahl beim ersten Bedarf.
func _get_choices() -> CanvasLayer:
if _choices == null:
_choices = CHOICES_SCENE.instantiate()
add_child(_choices)
return _choices
## Instanziiert die Dialog-Box beim ersten Bedarf.
func _get_box() -> CanvasLayer:
if _box == null:
_box = BOX_SCENE.instantiate()
add_child(_box)
return _box

View file

@ -30,6 +30,7 @@ var intellect := DEFAULT_INTELLECT
var blade_heart_tone := 0
var humanity := 0
var relationships: Dictionary = {}
var completed_dialogues: Dictionary = {}
var is_permadeath_enabled := true
@ -41,6 +42,7 @@ func reset() -> void:
blade_heart_tone = 0
humanity = 0
relationships.clear()
completed_dialogues.clear()
is_permadeath_enabled = true
blade_heart_tone_changed.emit(blade_heart_tone)
@ -95,6 +97,19 @@ func adjust_relationship(npc_id: String, amount: int) -> void:
set_relationship(npc_id, get_relationship(npc_id) + amount)
## Markiert einen Dialog als bereits geführt. Liegt hier statt im
## StorySystem, weil GameState das einzige gespeicherte Autoload ist und
## das Flag Save/Load überleben muss (sonst ließen sich Dialog-Effekte
## durch Neuladen erneut abgreifen).
func mark_dialogue_completed(dialogue_id: String) -> void:
completed_dialogues[dialogue_id] = true
## Gibt zurück, ob ein Dialog bereits vollständig geführt wurde.
func has_completed_dialogue(dialogue_id: String) -> bool:
return completed_dialogues.get(dialogue_id, false)
## Serialisiert den kompletten Zustand als Dictionary für das SaveSystem.
func to_save_dict() -> Dictionary:
return {
@ -104,6 +119,7 @@ func to_save_dict() -> Dictionary:
"blade_heart_tone": blade_heart_tone,
"humanity": humanity,
"relationships": relationships.duplicate(),
"completed_dialogues": completed_dialogues.duplicate(),
"is_permadeath_enabled": is_permadeath_enabled,
}
@ -123,6 +139,10 @@ func apply_save_dict(data: Dictionary) -> void:
var saved_relationships: Dictionary = data.get("relationships", {})
for npc_id in saved_relationships:
relationships[String(npc_id)] = clampi(int(saved_relationships[npc_id]), RELATIONSHIP_MIN, RELATIONSHIP_MAX)
completed_dialogues.clear()
var saved_dialogues: Dictionary = data.get("completed_dialogues", {})
for dialogue_id in saved_dialogues:
completed_dialogues[String(dialogue_id)] = bool(saved_dialogues[dialogue_id])
blade_heart_tone_changed.emit(blade_heart_tone)
for npc_id in relationships:
relationship_changed.emit(npc_id, relationships[npc_id])

102
scripts/ui/dialogue_box.gd Normal file
View file

@ -0,0 +1,102 @@
extends CanvasLayer
## Dialog-Box am unteren Bildrand im Stil von Baldur's Gate 3
## (Change Request, siehe docs/CHANGEREQUESTS_DONE.md).
##
## Zeigt jede Dialog-Zeile gut lesbar mit Sprechernamen an und beherbergt
## die fokus-navigierbare Antwortauswahl; die Sprechblasen über den Köpfen
## bleiben als Ambiente bestehen. Navigation über Pfeiltasten/D-Pad/linken
## Stick, Aktivierung über confirm (Enter/Ⓐ/✕) nach dem Muster des
## Hauptmenü-Fixes: Events, die auch Godots ui_accept matchen, verarbeitet
## der fokussierte Button selbst, nur die übrigen (Controller) lösen
## manuell aus. choose() liefert den Index der gewählten Option als
## Coroutine.
signal option_chosen(index: int)
@onready var _speaker_label: Label = $Root/Panel/Margin/Content/SpeakerLabel
@onready var _line_label: Label = $Root/Panel/Margin/Content/LineLabel
@onready var _options_box: VBoxContainer = $Root/Panel/Margin/Content/OptionsBox
## Startet unsichtbar; sichtbar wird die Box über show_line().
func _ready() -> void:
visible = false
## Zeigt eine Dialog-Zeile mit Sprechernamen; eine noch offene
## Antwortauswahl wird dabei geleert.
func show_line(speaker_name: String, text: String) -> void:
_speaker_label.text = speaker_name
_line_label.text = text
_clear_options()
visible = true
## Zeigt die Antwortoptionen unterhalb der aktuellen Zeile an und liefert
## den Index der gewählten Option, sobald der Spieler bestätigt hat.
func choose(option_texts: Array) -> int:
_show_options(option_texts)
var index: int = await option_chosen
return index
## Blendet die Box am Dialogende aus.
func hide_box() -> void:
_clear_options()
visible = false
## Meldet, ob gerade eine Antwortauswahl offen ist (auch für Test-Sonden).
func has_open_options() -> bool:
return visible and _options_box.visible
## Aktiviert mit confirm den fokussierten Options-Button (nur solange eine
## Auswahl offen ist); Fokus-Verlust wird auf die erste Option repariert.
func _unhandled_input(event: InputEvent) -> void:
if not has_open_options():
return
if not event.is_action_pressed("confirm"):
return
var focused := get_viewport().gui_get_focus_owner()
if focused == null or focused.get_parent() != _options_box:
if _options_box.get_child_count() > 0:
(_options_box.get_child(0) as 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()
## Baut die Options-Buttons neu auf und setzt den Fokus auf die erste
## Option.
func _show_options(option_texts: Array) -> void:
_clear_options()
var first_button: Button = null
for i in option_texts.size():
var button := Button.new()
button.text = str(option_texts[i])
button.custom_minimum_size = Vector2(0, 40)
button.pressed.connect(_on_option_pressed.bind(i))
_options_box.add_child(button)
if first_button == null:
first_button = button
_options_box.visible = true
if first_button != null:
first_button.grab_focus.call_deferred()
## Entfernt alle Options-Buttons und blendet die Options-Leiste aus.
func _clear_options() -> void:
for child in _options_box.get_children():
_options_box.remove_child(child)
child.queue_free()
_options_box.visible = false
## Schließt die Auswahl und meldet den gewählten Index.
func _on_option_pressed(index: int) -> void:
_clear_options()
option_chosen.emit(index)

View file

@ -1,71 +0,0 @@
extends CanvasLayer
## Fokus-navigierbare Antwortauswahl für Dialoge (Phase 2a).
##
## Baut zur Laufzeit Buttons für die Antwortoptionen eines Dialog-Knotens
## auf, unten mittig im Bild. Navigation über Pfeiltasten/D-Pad/linken
## Stick, Aktivierung über confirm (Enter/Ⓐ/✕) — nach demselben Muster wie
## im Hauptmenü: Events, die auch Godots ui_accept matchen, verarbeitet der
## fokussierte Button selbst, nur die restlichen (Controller) lösen manuell
## aus. choose() liefert den Index der gewählten Option als Coroutine.
signal option_chosen(index: int)
@onready var _options_box: VBoxContainer = $Root/OptionsBox
## Startet unsichtbar; sichtbar wird die Auswahl nur über choose().
func _ready() -> void:
visible = false
## Zeigt die Optionen an und liefert den Index der gewählten Option,
## sobald der Spieler bestätigt hat.
func choose(option_texts: Array) -> int:
_show_options(option_texts)
var index: int = await option_chosen
return index
## Aktiviert mit confirm den fokussierten Options-Button (nur solange die
## Auswahl sichtbar ist); Fokus-Verlust wird auf die erste Option repariert.
func _unhandled_input(event: InputEvent) -> void:
if not visible:
return
if not event.is_action_pressed("confirm"):
return
var focused := get_viewport().gui_get_focus_owner()
if focused == null or focused.get_parent() != _options_box:
if _options_box.get_child_count() > 0:
(_options_box.get_child(0) as 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()
## Baut die Options-Buttons neu auf und setzt den Fokus auf die erste
## Option.
func _show_options(option_texts: Array) -> void:
for child in _options_box.get_children():
_options_box.remove_child(child)
child.queue_free()
var first_button: Button = null
for i in option_texts.size():
var button := Button.new()
button.text = str(option_texts[i])
button.custom_minimum_size = Vector2(620, 44)
button.pressed.connect(_on_option_pressed.bind(i))
_options_box.add_child(button)
if first_button == null:
first_button = button
visible = true
if first_button != null:
first_button.grab_focus.call_deferred()
## Schließt die Auswahl und meldet den gewählten Index.
func _on_option_pressed(index: int) -> void:
visible = false
option_chosen.emit(index)