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>
This commit is contained in:
danny 2026-07-05 12:01:00 +02:00
parent d1e07cc06f
commit f0cd59c1e3
7 changed files with 415 additions and 19 deletions

View file

@ -1,32 +1,68 @@
extends StaticBody3D
## Ansprechbarer NPC mit daten-getriebenem Dialog (Phase 2a).
extends CharacterBody3D
## Ansprechbarer, wandernder NPC (Phasen 2a–2c).
##
## 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".
## 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.
## 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_state_changed)
DialogueSystem.dialogue_finished.connect(_on_dialogue_state_changed)
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.
## 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
@ -37,6 +73,63 @@ func _unhandled_input(event: InputEvent) -> void:
_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")
@ -49,6 +142,14 @@ func _start_dialogue() -> void:
})
## 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
@ -61,8 +162,24 @@ func _on_body_exited(_body: Node3D) -> void:
_update_prompt()
## Hält den Prompt während laufender Dialoge ausgeblendet.
func _on_dialogue_state_changed(_dialogue_id: String) -> void:
## 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()