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

@ -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