windgeschworen/scripts/gameplay/ambient_chatter.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

170 lines
5.9 KiB
GDScript

extends Node
## Ambient-Gespräche zwischen NPCs (Phase 2c), Szenen-lokaler Manager.
##
## Prüft periodisch alle NPC-Paare (Gruppe "npc"): Sind sich zwei
## verfügbare NPCs nahe genug und existiert für das Paar ein Austausch in
## data/dialogue/ambient_lines.json, startet er mit exchange_chance einen
## zufällig gewählten kurzen Wortwechsel — über die Sprechblasen, nicht
## über die Chatbox: Die Box ist das Spieler-Dialog-UI mit
## Auswahl-Semantik und würde Spieler-Beteiligung suggerieren;
## Ambient-Zeilen sind Welt-Ambiente ohne Auswahl und gehören räumlich zu
## den Figuren. Ambient-Gespräche verändern keine Werte und sperren den
## Spieler nicht. Spricht der Spieler einen beteiligten NPC an, bricht
## der Austausch sofort ab; NPCs im Spieler-Dialog werden nie
## Ambient-Partner. Pro Paar gilt ein Cooldown.
const LINES_PATH := "res://data/dialogue/ambient_lines.json"
const CHECK_INTERVAL := 3.0
const PROXIMITY := 4.0
const PAIR_COOLDOWN_MS := 25000
@export var exchange_chance := 0.35
var _exchanges: Array = []
var _cooldowns: Dictionary = {}
var _check_remaining := CHECK_INTERVAL
var _active_npcs: Array = []
var _is_exchange_running := false
var _is_exchange_aborted := false
## Lädt die Austausch-Daten und lauscht auf Spieler-Dialog-Starts.
func _ready() -> void:
_exchanges = _load_exchanges()
DialogueSystem.dialogue_started.connect(_on_player_dialogue_started)
## Prüft im Intervall, ob ein Ambient-Austausch starten kann.
func _process(delta: float) -> void:
if _is_exchange_running or _exchanges.is_empty():
return
_check_remaining -= delta
if _check_remaining > 0.0:
return
_check_remaining = CHECK_INTERVAL
_try_start_exchange()
## Liest und validiert die Ambient-Datei; leeres Array bei Fehlern.
func _load_exchanges() -> Array:
var file := FileAccess.open(LINES_PATH, FileAccess.READ)
if file == null:
push_error("Ambient-Datei nicht lesbar: %s (%s)" % [LINES_PATH, error_string(FileAccess.get_open_error())])
return []
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if not (parsed is Dictionary) or not (parsed.get("exchanges") is Array):
push_error("Ambient-Datei ist keine gültige Austausch-Liste: %s" % LINES_PATH)
return []
return parsed["exchanges"]
## Sucht das erste verfügbare, nahe NPC-Paar mit passendem Austausch und
## würfelt den Start über exchange_chance aus.
func _try_start_exchange() -> void:
var npcs := get_tree().get_nodes_in_group("npc")
for i in npcs.size():
for j in range(i + 1, npcs.size()):
var npc_a: Node3D = npcs[i]
var npc_b: Node3D = npcs[j]
if not (npc_a.can_start_ambient() and npc_b.can_start_ambient()):
continue
if npc_a.global_position.distance_to(npc_b.global_position) > PROXIMITY:
continue
if _is_pair_on_cooldown(npc_a.npc_id, npc_b.npc_id):
continue
var exchange := _pick_exchange(npc_a.npc_id, npc_b.npc_id)
if exchange.is_empty():
continue
if randf() > exchange_chance:
continue
_run_exchange(npc_a, npc_b, exchange)
return
## Wählt zufällig einen Austausch für das Paar (Reihenfolge egal),
## leeres Dictionary wenn keiner existiert.
func _pick_exchange(id_a: String, id_b: String) -> Dictionary:
var candidates: Array = []
for exchange in _exchanges:
var pair: Array = exchange.get("npcs", [])
if pair.size() != 2:
continue
if (pair[0] == id_a and pair[1] == id_b) or (pair[0] == id_b and pair[1] == id_a):
candidates.append(exchange)
if candidates.is_empty():
return {}
return candidates.pick_random()
## Spielt einen Austausch als Coroutine über die Sprechblasen der beiden
## NPCs ab; ein Abbruch (Spieler-Interaktion) beendet ihn sofort sauber.
func _run_exchange(npc_a: Node3D, npc_b: Node3D, exchange: Dictionary) -> void:
_is_exchange_running = true
_is_exchange_aborted = false
_active_npcs = [npc_a, npc_b]
npc_a.begin_ambient(npc_b.global_position)
npc_b.begin_ambient(npc_a.global_position)
var by_id := { npc_a.npc_id: npc_a, npc_b.npc_id: npc_b }
for line in exchange.get("lines", []):
if _is_exchange_aborted:
break
var speaker: Node3D = by_id.get(str(line.get("speaker", "")))
if speaker == null:
continue
var bubble: Node = speaker.get_node_or_null("SpeechBubble")
if bubble == null:
continue
bubble.show_line(str(line.get("text", "")))
await _wait_for_bubble(bubble)
for npc in _active_npcs:
npc.end_ambient()
_set_pair_cooldown(npc_a.npc_id, npc_b.npc_id)
_active_npcs = []
_is_exchange_running = false
## Wartet das Zeilenende einer Sprechblase ab, bricht bei Abbruch früh ab.
func _wait_for_bubble(bubble: Node) -> void:
while bubble.visible and not _is_exchange_aborted:
await get_tree().process_frame
if _is_exchange_aborted:
bubble.hide_bubble()
## Bricht den laufenden Austausch ab, wenn der Spieler einen der
## beteiligten NPCs anspricht.
func _on_player_dialogue_started(_dialogue_id: String) -> void:
if not _is_exchange_running:
return
for npc in _active_npcs:
if DialogueSystem.is_speaker(npc):
_abort_exchange()
return
## Blendet die Blasen aus und entlässt die NPCs aus dem Ambient-Zustand;
## der NPC im Spieler-Dialog bleibt davon unberührt.
func _abort_exchange() -> void:
_is_exchange_aborted = true
for npc in _active_npcs:
var bubble: Node = npc.get_node_or_null("SpeechBubble")
if bubble != null:
bubble.hide_bubble()
npc.end_ambient()
## Gibt zurück, ob das Paar noch im Cooldown steckt.
func _is_pair_on_cooldown(id_a: String, id_b: String) -> bool:
var key := _pair_key(id_a, id_b)
return _cooldowns.has(key) and Time.get_ticks_msec() - _cooldowns[key] < PAIR_COOLDOWN_MS
## Startet den Cooldown für das Paar.
func _set_pair_cooldown(id_a: String, id_b: String) -> void:
_cooldowns[_pair_key(id_a, id_b)] = Time.get_ticks_msec()
## Liefert einen reihenfolge-unabhängigen Schlüssel für ein NPC-Paar.
func _pair_key(id_a: String, id_b: String) -> String:
return "%s|%s" % [mini(id_a.hash(), id_b.hash()), maxi(id_a.hash(), id_b.hash())]