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:
parent
d1e07cc06f
commit
f0cd59c1e3
7 changed files with 415 additions and 19 deletions
|
|
@ -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()
|
||||
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue