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