windgeschworen/scripts/gameplay/npc_dialogue.gd
danny f0cd59c1e3 Phase 2c: NPC-Wander-KI + Ambient-Gespraeche
- npc_dialogue.gd: NPCs sind jetzt CharacterBody3D mit Zustandsmaschine
  (IDLE/WALKING/PLAYER_DIALOGUE/AMBIENT); Wandern zwischen
  Marker3D-Wegpunkten mit zufaelligen Wartezeiten, Kollisionsmaske
  inkl. Spieler; Wander-KI pausiert, solange der NPC Sprecher des
  Spieler-Dialogs ist, und wendet sich dem Spieler zu; Interaktions-
  Trigger haengt am Root und wandert mit
- DialogueSystem.is_speaker() fuer KI-Pause und Ambient-Abbruch
- AmbientChatter (Szenen-Manager) + data/dialogue/ambient_lines.json:
  sechs kanon-neutrale Kurz-Wechsel (Imogen/Violet, Rhiannon/Wren,
  Violet/Wren, Imogen/Rhiannon); Start bei Naehe mit Wahrscheinlichkeit
  und Pair-Cooldown; Wiedergabe ueber Sprechblasen (Chatbox bleibt dem
  Spieler-Dialog vorbehalten, Ambient ist Welt-Ambiente ohne Auswahl);
  keine Werte-Effekte, keine Spieler-Sperre; Spieler-Interaktion mit
  beteiligtem NPC bricht den Austausch sofort sauber ab
- Debug-Overlay zeigt die NPC-Zustaende
- Headless verifiziert (19 Checks): Wandern, Dialog-Pause mitten in der
  Bewegung, forcierter Ambient-Austausch, Werte-Neutralitaet, keine
  Spieler-Sperre, sauberer Ambient-Abbruch bei Interaktion

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-05 12:01:00 +02:00

188 lines
6.3 KiB
GDScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

extends CharacterBody3D
## Ansprechbarer, wandernder NPC (Phasen 2a–2c).
##
## Dialog: Zeigt in Reichweite (Area3D-Trigger am NPC-Root, wandert mit)
## einen Interaktions-Prompt und startet bei der interact-Action den
## Dialogbaum aus dialogue_path über das DialogueSystem; doppeltes Öffnen
## wird hier und im DialogueSystem verhindert. Wander-KI (Phase 2c):
## Der NPC pendelt zwischen den Marker3D-Wegpunkten aus waypoint_paths
## mit zufälligen Wartezeiten. Zustände: IDLE (warten), WALKING (zum
## Wegpunkt), PLAYER_DIALOGUE (KI pausiert, solange dieser NPC Sprecher
## des Spieler-Dialogs ist), AMBIENT (kurzer NPC-zu-NPC-Austausch,
## gesteuert vom AmbientChatter der Szene). NPC-IDs sind
## snake_case-Strings, z. B. "imogen".
enum NpcState { IDLE, WALKING, PLAYER_DIALOGUE, AMBIENT }
const ARRIVAL_DISTANCE := 0.35
const WAIT_TIME_MIN := 2.5
const WAIT_TIME_MAX := 6.0
const MESH_TURN_SPEED := 8.0
@export var npc_id := "imogen"
@export_file("*.json") var dialogue_path: String
@export var waypoint_paths: Array[NodePath] = []
@export var walk_speed := 1.6
var _state := NpcState.IDLE
var _is_player_in_range := false
var _waypoints: Array[Vector3] = []
var _current_waypoint := 0
var _wait_remaining := 0.0
var _gravity: float = ProjectSettings.get_setting("physics/3d/default_gravity")
@onready var _prompt_label: Label3D = $PromptLabel
@onready var _interaction_area: Area3D = $InteractionArea
@onready var _mesh: MeshInstance3D = $MeshInstance3D
## Verbindet Reichweiten- und Dialog-Signale und löst die Wegpunkte auf.
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_started)
DialogueSystem.dialogue_finished.connect(_on_dialogue_finished)
for path in waypoint_paths:
var marker := get_node_or_null(path) as Node3D
if marker != null:
_waypoints.append(marker.global_position)
_wait_remaining = randf_range(WAIT_TIME_MIN, WAIT_TIME_MAX)
## Treibt die Wander-KI an; in Dialog- und Ambient-Zuständen steht der NPC.
func _physics_process(delta: float) -> void:
match _state:
NpcState.IDLE:
_process_idle(delta)
NpcState.WALKING:
_process_walking(delta)
_:
velocity = Vector3.ZERO
## Startet den Dialog, wenn der Spieler in Reichweite ist, interact drückt
## und noch kein Dialog läuft (auch mitten in der Bewegung oder während
## eines Ambient-Austauschs).
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()
## Meldet, ob der NPC für ein Ambient-Gespräch verfügbar ist (wandert oder
## wartet, ist also weder im Spieler-Dialog noch schon im Austausch).
func can_start_ambient() -> bool:
return _state == NpcState.IDLE or _state == NpcState.WALKING
## Versetzt den NPC in den Ambient-Zustand und dreht ihn zum Partner.
func begin_ambient(partner_position: Vector3) -> void:
_state = NpcState.AMBIENT
velocity = Vector3.ZERO
_face_towards(partner_position)
## Beendet den Ambient-Zustand und lässt den NPC nach kurzer Wartezeit
## weiterwandern; in anderen Zuständen passiert nichts.
func end_ambient() -> void:
if _state == NpcState.AMBIENT:
_state = NpcState.IDLE
_wait_remaining = randf_range(WAIT_TIME_MIN, WAIT_TIME_MAX)
## Liefert den Zustandsnamen für das Debug-Overlay.
func get_state_name() -> String:
return NpcState.keys()[_state]
## Zählt die Wartezeit herunter und peilt dann den nächsten Wegpunkt an.
func _process_idle(delta: float) -> void:
if _waypoints.size() < 2:
return
_wait_remaining -= delta
if _wait_remaining <= 0.0:
_current_waypoint = (_current_waypoint + 1) % _waypoints.size()
_state = NpcState.WALKING
## Geht zum aktuellen Wegpunkt und wechselt bei Ankunft in die Wartezeit.
func _process_walking(delta: float) -> void:
var to_target := _waypoints[_current_waypoint] - global_position
to_target.y = 0.0
if to_target.length() <= ARRIVAL_DISTANCE:
velocity = Vector3.ZERO
_state = NpcState.IDLE
_wait_remaining = randf_range(WAIT_TIME_MIN, WAIT_TIME_MAX)
return
var direction := to_target.normalized()
velocity.x = direction.x * walk_speed
velocity.z = direction.z * walk_speed
if not is_on_floor():
velocity.y -= _gravity * delta
else:
velocity.y = 0.0
move_and_slide()
var target_yaw := atan2(-direction.x, -direction.z)
_mesh.rotation.y = lerp_angle(_mesh.rotation.y, target_yaw, minf(MESH_TURN_SPEED * delta, 1.0))
## Ü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,
})
## Dreht das Kapsel-Mesh zu einer Zielposition.
func _face_towards(target: Vector3) -> void:
var direction := target - global_position
direction.y = 0.0
if direction.length_squared() > 0.01:
_mesh.rotation.y = atan2(-direction.x, -direction.z)
## 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()
## Pausiert die Wander-KI und wendet sich dem Spieler zu, wenn dieser NPC
## Sprecher des gestarteten Dialogs ist; hält außerdem den Prompt aktuell.
func _on_dialogue_started(_dialogue_id: String) -> void:
if DialogueSystem.is_speaker(self):
_state = NpcState.PLAYER_DIALOGUE
velocity = Vector3.ZERO
var player := get_tree().get_first_node_in_group("player") as Node3D
if player != null:
_face_towards(player.global_position)
_update_prompt()
## Lässt die Wander-KI nach dem Dialog weiterlaufen und aktualisiert den
## Prompt.
func _on_dialogue_finished(_dialogue_id: String) -> void:
if _state == NpcState.PLAYER_DIALOGUE:
_state = NpcState.IDLE
_wait_remaining = randf_range(WAIT_TIME_MIN, WAIT_TIME_MAX)
_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