windgeschworen/scripts/gameplay/combat/combat_encounter.gd
danny 9352ec277b Encounter: Nachschub, Neustart und zielender Fall-Schlag
- CombatEncounter.add_enemy: weiterer Gegner in einen laufenden Encounter,
  der erst endet, wenn auch der Nachschub am Boden ist (HUD bekommt den
  Balken mit, auch wenn die Anzeige schon wegerodiert ist).
- stop() loest die Verbindung zu Tyrveils Tod; bei gesperrtem Tod wurde sie
  nie verbraucht und derselbe Rahmen liess sich nicht erneut starten.
- Der automatische Fall-Schlag (CR 45) dreht Tyrveil zum naechsten Gegner
  in Reichweite. Ohne Eingabe dreht sich der Koerper nicht; gemessen gingen
  21 von 21 Schlaegen daneben, mit Ausrichtung treffen 16 von 19.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-14 18:32:17 +02:00

102 lines
3.1 KiB
GDScript

class_name CombatEncounter
extends Node
## Ablauf-Steuerung eines Kampf-Encounters (CR 8d).
##
## Gemeinsamer Rahmen für Sparring und den Tag-9-Hinterhalt: schaltet
## Tyrveils Kampf-Kern scharf, aktiviert die Gegner-KI, baut das
## Kampf-HUD auf und beendet den Encounter, sobald alle Gegner am Boden
## sind (Sieg) oder Tyrveil fällt (Niederlage). Die **Bewegung bleibt
## frei** — der Spieler ist nicht gesperrt, das ist der Unterschied zum
## alten QTE. Was aus Sieg oder Niederlage folgt (Dialog, Tod, Weiche),
## entscheidet die aufrufende Szene über das finished-Signal; hier gibt
## es bewusst keine Story-Logik.
signal finished(is_won: bool)
const HUD_SCENE := preload("res://scenes/ui/combat_hud.tscn")
var is_running := false
var _enemies: Array = []
var _player: CharacterBody3D
var _player_combat: CombatActor
var _hud: CanvasLayer
## Startet den Encounter mit den übergebenen Gegner-Knoten
## (EnemyCombatant). Liefert false, wenn kein Spieler gefunden wurde.
func start(enemies: Array) -> bool:
if is_running:
return false
_player = get_tree().get_first_node_in_group("player") as CharacterBody3D
if _player == null:
push_warning("Kein Spieler für den Encounter gefunden.")
return false
_player_combat = _player.get_node_or_null("PlayerCombat") as CombatActor
if _player_combat == null:
push_warning("Spieler hat keinen PlayerCombat-Knoten.")
return false
_enemies = enemies
is_running = true
_player_combat.set_encounter_active(true)
_player_combat.died.connect(_on_player_died, CONNECT_ONE_SHOT)
for enemy in _enemies:
enemy.set_active(true)
enemy.died.connect(_on_enemy_died)
_hud = HUD_SCENE.instantiate()
add_child(_hud)
_hud.setup(_player_combat, _enemies)
return true
## Schickt einem laufenden Encounter einen weiteren Gegner nach (Akt 3 K3:
## Nachschub, solange die Erosion läuft). Der Encounter endet weiterhin erst,
## wenn alle — auch die nachgerückten — am Boden sind.
func add_enemy(enemy: CombatActor) -> bool:
if not is_running or _enemies.has(enemy):
return false
_enemies.append(enemy)
enemy.set_active(true)
enemy.died.connect(_on_enemy_died)
if _hud != null:
_hud.add_enemy(enemy)
return true
## Beendet den Encounter vorzeitig (Abbruch durch die Szene). Löst auch die
## Verbindung zu Tyrveils Tod — ist der gesperrt (Akt 3 K3), wird sie nie
## verbraucht, und derselbe Rahmen könnte sonst nicht erneut starten.
func stop() -> void:
if not is_running:
return
is_running = false
if _player_combat.died.is_connected(_on_player_died):
_player_combat.died.disconnect(_on_player_died)
_player_combat.set_encounter_active(false)
for enemy in _enemies:
if is_instance_valid(enemy):
enemy.set_active(false)
if _hud != null:
_hud.queue_free()
_hud = null
## Prüft nach jedem Gegner-Tod, ob der Encounter gewonnen ist.
func _on_enemy_died() -> void:
for enemy in _enemies:
if is_instance_valid(enemy) and enemy.is_alive():
return
_end(true)
## Tyrveil ist gefallen — der Encounter ist verloren.
func _on_player_died() -> void:
_end(false)
## Räumt auf und meldet den Ausgang.
func _end(is_won: bool) -> void:
if not is_running:
return
stop()
finished.emit(is_won)