- 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>
188 lines
6.3 KiB
GDScript
188 lines
6.3 KiB
GDScript
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
|