Phase 2a: Dialog-System, Sprechblasen, Imogen-Intro-Gespraech

- speech_bubble.tscn/gd: wiederverwendbare Billboard-Sprechblase mit
  textlaengenabhaengiger Anzeigedauer und Sticky-Modus, haengt an Spieler
  (player.tscn) und Imogen (rider_quadrant.tscn)
- Dialog-Datenformat als JSON unter data/dialogue: Knoten mit speaker/
  text/options, Options-Tags blade_heart und relationship (NPC-ID -> Delta),
  next-Verweis; imogen_intro.json mit zwei Entscheidungspunkten in Imogens
  Stimme (Akt 1, keine Wahrheiten vorweggenommen)
- DialogueSystem: laedt/validiert Dialogbaeume, spielt Zeilen ueber die
  Sprechblase des jeweiligen Sprechers (gewaehlte Antwort ueber Tyrveils
  Kopf), wendet Options-Tags auf GameState/RelationshipSystem an, Signale
  dialogue_started/dialogue_finished
- dialogue_choices.tscn/gd: fokus-navigierbare Antwortauswahl unten mittig,
  confirm-Aktivierung nach dem Muster des Hauptmenue-Fixes
- npc_placeholder.gd -> npc_dialogue.gd: startet den echten Dialog,
  Konsolen-Platzhalter und Cooldown entfernt, doppeltes Oeffnen doppelt
  abgesichert, Prompt waehrend Dialog ausgeblendet
- player.gd: Bewegungs- und Look-Sperre ueber die Dialog-Signale, laufender
  Slide endet bei Dialogbeginn sauber
- Debug-Overlay blendet sich waehrend Dialogen aus
- Headless verifiziert: kompletter Dialog-Durchlauf mit Tastatur- UND
  Controller-Bestaetigung, Klinge/Herz +10, Beziehung Imogen +4,
  Bewegungssperre und Overlay-/Prompt-Verhalten

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-04 19:41:52 +02:00
parent 806d938ada
commit 610cd14760
15 changed files with 501 additions and 74 deletions

View file

@ -1,7 +1,143 @@
extends Node
## Daten-getriebenes Dialog-System (Autoload, SPEC.md Abschnitte 6 und 8).
##
## Spielt ab Phase 2 verzweigte Dialogbäume aus data/dialogue ab.
## Entscheidungen tragen Klinge/Herz-Tags und wirken auf den Ton-Wert, auf
## Beziehungswerte und auf Story-Flags. Die Dialog-UI ist fokus-navigierbar
## (D-Pad/Stick). Phase 0: leeres Skelett ohne Logik.
## 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.
signal dialogue_started(dialogue_id: String)
signal dialogue_finished(dialogue_id: String)
const CHOICES_SCENE := preload("res://scenes/ui/dialogue_choices.tscn")
const PLAYER_SPEAKER_ID := "player"
var is_dialogue_active := false
var _speakers: Dictionary = {}
var _choices: 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
_speakers = speakers
is_dialogue_active = true
dialogue_started.emit(str(data["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 die Sprechblasen,
## Entscheidungen über die Antwortauswahl, Effekte über die Options-Tags.
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)
else:
node_id = await _play_choice(bubble, 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:
if bubble != null:
bubble.show_line(str(node.get("text", "")))
await bubble.line_finished
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
## die ID des Folge-Knotens.
func _play_choice(bubble: Node, node: Dictionary, options: Array) -> String:
if bubble != null:
bubble.show_line(str(node.get("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)
if bubble != null:
bubble.hide_bubble()
var option: Dictionary = options[clampi(index, 0, options.size() - 1)]
_apply_option_effects(option)
var player_bubble := _bubble_for(PLAYER_SPEAKER_ID)
if player_bubble != null:
player_bubble.show_line(str(option.get("text", "")))
await player_bubble.line_finished
return _next_id(option)
## Wendet die Effekt-Tags einer Option an: blade_heart verschiebt die
## Klinge-↔-Herz-Achse, relationship verschiebt Beziehungswerte pro NPC.
func _apply_option_effects(option: Dictionary) -> void:
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 und gibt die Sprecher-Referenzen frei.
func _end_dialogue(dialogue_id: String) -> void:
is_dialogue_active = false
_speakers.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 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 Antwortauswahl beim ersten Bedarf.
func _get_choices() -> CanvasLayer:
if _choices == null:
_choices = CHOICES_SCENE.instantiate()
add_child(_choices)
return _choices

View file

@ -0,0 +1,71 @@
extends StaticBody3D
## Ansprechbarer NPC mit daten-getriebenem Dialog (Phase 2a).
##
## Zeigt in Reichweite (Area3D-Trigger) einen Interaktions-Prompt und
## startet bei der interact-Action den Dialogbaum aus dialogue_path über
## das DialogueSystem. Während eines laufenden Dialogs ist keine erneute
## Interaktion möglich und der Prompt bleibt ausgeblendet — ein doppeltes
## Öffnen wird sowohl hier als auch im DialogueSystem verhindert. NPC-IDs
## sind snake_case-Strings, z. B. "imogen".
@export var npc_id := "imogen"
@export_file("*.json") var dialogue_path: String
var _is_player_in_range := false
@onready var _prompt_label: Label3D = $PromptLabel
@onready var _interaction_area: Area3D = $InteractionArea
## Verbindet Reichweiten- und Dialog-Signale.
func _ready() -> void:
_interaction_area.body_entered.connect(_on_body_entered)
_interaction_area.body_exited.connect(_on_body_exited)
DialogueSystem.dialogue_started.connect(_on_dialogue_state_changed)
DialogueSystem.dialogue_finished.connect(_on_dialogue_state_changed)
## Startet den Dialog, wenn der Spieler in Reichweite ist, interact drückt
## und noch kein Dialog läuft.
func _unhandled_input(event: InputEvent) -> void:
if not _is_player_in_range:
return
if DialogueSystem.is_dialogue_active:
return
if not event.is_action_pressed("interact"):
return
_start_dialogue()
## Übergibt sich selbst und den Spieler als Sprecher an das DialogueSystem.
func _start_dialogue() -> void:
var player := get_tree().get_first_node_in_group("player")
if player == null:
push_warning("Kein Spieler für den Dialog mit '%s' gefunden." % npc_id)
return
DialogueSystem.start_dialogue(dialogue_path, {
npc_id: self,
DialogueSystem.PLAYER_SPEAKER_ID: player,
})
## Blendet den Prompt ein, sobald der Spieler die Reichweite betritt.
func _on_body_entered(_body: Node3D) -> void:
_is_player_in_range = true
_update_prompt()
## Blendet den Prompt aus, wenn der Spieler die Reichweite verlässt.
func _on_body_exited(_body: Node3D) -> void:
_is_player_in_range = false
_update_prompt()
## Hält den Prompt während laufender Dialoge ausgeblendet.
func _on_dialogue_state_changed(_dialogue_id: String) -> void:
_update_prompt()
## Zeigt den Prompt nur in Reichweite und außerhalb laufender Dialoge.
func _update_prompt() -> void:
_prompt_label.visible = _is_player_in_range and not DialogueSystem.is_dialogue_active

View file

@ -1,60 +0,0 @@
extends StaticBody3D
## Platzhalter-NPC für Phase 1a — minimaler Testfall für die
## Beziehungswerte, bewusst ohne das Dialog-System aus Phase 2.
##
## Zeigt in Reichweite (Area3D-Trigger) einen Interaktions-Prompt, gibt bei
## der interact-Action eine fest hinterlegte Zeile in der Godot-Konsole aus
## und erhöht den Beziehungswert der konfigurierten NPC-ID über
## RelationshipSystem um relationship_gain. Ein Cooldown verhindert, dass
## Spam-Interaktion den Wert durchknallt. NPC-ID-Konvention für Phase 2:
## snake_case, z. B. "imogen".
const INTERACTION_COOLDOWN_MS := 2000
@export var npc_id := "imogen"
@export var display_name := "Imogen"
@export var placeholder_line := "Immer noch in einem Stück? Gut. Erspar mir die Sorge, Tyrveil."
@export var relationship_gain := 2
var _is_player_in_range := false
var _last_interaction_ms := -INTERACTION_COOLDOWN_MS
@onready var _prompt_label: Label3D = $PromptLabel
@onready var _interaction_area: Area3D = $InteractionArea
## Verbindet die Reichweiten-Signale des Area3D-Triggers.
func _ready() -> void:
_interaction_area.body_entered.connect(_on_body_entered)
_interaction_area.body_exited.connect(_on_body_exited)
## Löst die Interaktion aus, wenn der Spieler in Reichweite ist, interact
## gedrückt wird und der Cooldown abgelaufen ist.
func _unhandled_input(event: InputEvent) -> void:
if not _is_player_in_range:
return
if not event.is_action_pressed("interact"):
return
if Time.get_ticks_msec() - _last_interaction_ms < INTERACTION_COOLDOWN_MS:
return
_interact()
## Konsolen-Ausgabe als Dialog-Platzhalter plus Beziehungs-Zuwachs.
func _interact() -> void:
_last_interaction_ms = Time.get_ticks_msec()
print("%s: %s" % [display_name, placeholder_line])
RelationshipSystem.adjust_relationship(npc_id, relationship_gain)
## Blendet den Prompt ein, sobald der Spieler die Reichweite betritt.
func _on_body_entered(_body: Node3D) -> void:
_is_player_in_range = true
_prompt_label.visible = true
## Blendet den Prompt aus, wenn der Spieler die Reichweite verlässt.
func _on_body_exited(_body: Node3D) -> void:
_is_player_in_range = false
_prompt_label.visible = false

View file

@ -48,6 +48,7 @@ const CLIMB_DURATION := 0.4
const CLIMB_VERTICAL_PHASE := 0.6
var _state := MovementState.NORMAL
var _is_dialogue_locked := false
var _target_zoom := 9.0
var _gravity: float = ProjectSettings.get_setting("physics/3d/default_gravity")
var _slide_direction := Vector3.ZERO
@ -65,19 +66,23 @@ var _climb_time := 0.0
@onready var _capsule: CapsuleShape3D = _collision_shape.shape.duplicate()
## Fängt den Mauszeiger ein, übernimmt die SpringArm-Länge als Zoom-Ziel
## und gibt dem Spieler eine eigene Kapsel-Shape-Instanz.
## Fängt den Mauszeiger ein, übernimmt die SpringArm-Länge als Zoom-Ziel,
## gibt dem Spieler eine eigene Kapsel-Shape-Instanz und koppelt die
## Bewegungssperre an die Dialog-Signale.
func _ready() -> void:
Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED)
_target_zoom = _spring_arm.spring_length
_collision_shape.shape = _capsule
DialogueSystem.dialogue_started.connect(_on_dialogue_started)
DialogueSystem.dialogue_finished.connect(_on_dialogue_finished)
## Verarbeitet Maus-Look, Mausrad-Zoom sowie das Freigeben des Cursors über
## cancel und das Wieder-Einfangen per Mausklick.
func _unhandled_input(event: InputEvent) -> void:
if event is InputEventMouseMotion and Input.get_mouse_mode() == Input.MOUSE_MODE_CAPTURED:
_rotate_camera(-event.relative.x * MOUSE_SENSITIVITY, -event.relative.y * MOUSE_SENSITIVITY)
if not _is_dialogue_locked:
_rotate_camera(-event.relative.x * MOUSE_SENSITIVITY, -event.relative.y * MOUSE_SENSITIVITY)
elif event is InputEventMouseButton and event.pressed:
if event.is_action("camera_zoom_in"):
_target_zoom = clampf(_target_zoom - ZOOM_STEP, ZOOM_MIN, ZOOM_MAX)
@ -89,8 +94,12 @@ func _unhandled_input(event: InputEvent) -> void:
Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
## Treibt Kamera und den aktiven Bewegungszustand pro Physik-Tick an.
## Treibt Kamera und den aktiven Bewegungszustand pro Physik-Tick an;
## während eines Dialogs sind Bewegung und Kamera-Look gesperrt.
func _physics_process(delta: float) -> void:
if _is_dialogue_locked:
_process_dialogue_lock(delta)
return
_apply_stick_look(delta)
_apply_button_zoom(delta)
_apply_zoom_smoothing(delta)
@ -103,6 +112,30 @@ func _physics_process(delta: float) -> void:
_process_climb(delta)
## Hält den Spieler während eines Dialogs an: Schwerkraft und Auslaufen
## bleiben aktiv, Eingaben für Bewegung, Sprung, Slide und Look nicht.
func _process_dialogue_lock(delta: float) -> void:
if not is_on_floor():
velocity.y -= _gravity * delta
velocity.x = move_toward(velocity.x, 0.0, STOP_SPEED * delta)
velocity.z = move_toward(velocity.z, 0.0, STOP_SPEED * delta)
move_and_slide()
_apply_zoom_smoothing(delta)
## Sperrt Bewegung und Look bei Dialogbeginn; ein laufender Slide endet
## sauber, damit die Kapsel nicht geduckt stehen bleibt.
func _on_dialogue_started(_dialogue_id: String) -> void:
if _state == MovementState.SLIDING:
_end_slide()
_is_dialogue_locked = true
## Gibt Bewegung und Look nach Dialogende wieder frei.
func _on_dialogue_finished(_dialogue_id: String) -> void:
_is_dialogue_locked = false
## Liefert die aktuelle Kamera-Distanz in Metern für das Debug-Overlay.
func get_camera_zoom() -> float:
return _spring_arm.spring_length

View file

@ -25,13 +25,25 @@ var _player: CharacterBody3D
@onready var _info_label: Label = $InfoLabel
## Löst die Spieler-Referenz auf: bevorzugt über den exportierten Pfad,
## sonst über die Gruppe "player" (Standard seit der Szenen-Extraktion in
## Phase 1b).
## Löst die Spieler-Referenz auf (bevorzugt über den exportierten Pfad,
## sonst über die Gruppe "player") und blendet das Overlay während
## laufender Dialoge aus, damit es nicht über den Sprechblasen liegt.
func _ready() -> void:
_player = get_node_or_null(player_path) as CharacterBody3D
if _player == null:
_player = get_tree().get_first_node_in_group("player") as CharacterBody3D
DialogueSystem.dialogue_started.connect(_on_dialogue_started)
DialogueSystem.dialogue_finished.connect(_on_dialogue_finished)
## Blendet das Overlay bei Dialogbeginn aus.
func _on_dialogue_started(_dialogue_id: String) -> void:
visible = false
## Blendet das Overlay nach Dialogende wieder ein.
func _on_dialogue_finished(_dialogue_id: String) -> void:
visible = true
## Merkt sich das zuletzt benutzte Eingabegerät anhand des Event-Typs;

View file

@ -0,0 +1,71 @@
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)

View file

@ -0,0 +1 @@
uid://c3dm52fv7tk2a

View file

@ -0,0 +1,46 @@
extends Node3D
## Wiederverwendbare Sprechblase über dem Kopf eines Sprechers (Phase 2a).
##
## Billboard-Label3D, das an jedem Node mit Kopf-Ankerpunkt hängen kann —
## NPCs wie Spieler nutzen dieselbe Szene (scenes/ui/speech_bubble.tscn,
## als Kind "SpeechBubble" des Sprechers). Die Anzeigedauer richtet sich
## nach der Textlänge; im Sticky-Modus bleibt die Zeile stehen, bis
## hide_bubble() aufgerufen wird (für Knoten mit offener Antwortauswahl).
signal line_finished
const BASE_DURATION := 1.2
const SECONDS_PER_CHAR := 0.055
const MIN_DURATION := 2.0
const MAX_DURATION := 7.0
var _remaining := 0.0
var _is_sticky := false
@onready var _label: Label3D = $Label3D
## Blendet die Zeile ein. Bei is_sticky bleibt sie bis hide_bubble()
## stehen, sonst blendet sie nach textlängenabhängiger Dauer aus und
## meldet line_finished.
func show_line(text: String, is_sticky := false) -> void:
_label.text = text
_is_sticky = is_sticky
_remaining = clampf(BASE_DURATION + text.length() * SECONDS_PER_CHAR, MIN_DURATION, MAX_DURATION)
visible = true
## Blendet die Sprechblase sofort aus, ohne line_finished zu melden.
func hide_bubble() -> void:
visible = false
_label.text = ""
## Zählt die Anzeigedauer herunter und meldet das Zeilenende.
func _process(delta: float) -> void:
if not visible or _is_sticky:
return
_remaining -= delta
if _remaining <= 0.0:
hide_bubble()
line_finished.emit()

View file

@ -0,0 +1 @@
uid://cfd8d4c7sh5s2