windgeschworen/scripts/gameplay/combat/combat_encounter.gd
danny b96b07b7d9 CR 8d: Encounter-Umbau — Sparring und Tag-9 auf dem echten Kampfsystem
- EnemyCombatant: Gegner-KI auf CombatActor-Basis, nähert sich, hält
  Distanz, kündigt Schläge sichtbar an und blockt gelegentlich; Werte
  über Exports, damit Partner und Schergen dieselbe Klasse nutzen
- CombatEncounter: gemeinsamer Rahmen (Kampf-Kern scharf, Gegner aktiv,
  HUD, Sieg/Niederlage über finished) — bewusst ohne Story-Logik
- Kampf-HUD (scenes/ui/combat_hud.tscn): HP + Ausdauer, ein Balken je
  Gegner, Waffe und Waffenskill
- Sparring: Timing-Duell ersetzt durch echten Encounter gegen den
  Staffel-Partner; Bewegung bleibt frei, nie tödlich (Niederlage führt
  in sparring_loss statt in den Respawn)
- Tag-9-Hinterhalt: QTE-Kette samt UI entfernt, Cassian und beide
  Schergen kämpfen gleichzeitig; Niederlage = Tod → letzter Spielstand
  (CR 16), Sieg führt unverändert in die Herz/Klinge-Weiche
- Option B gewahrt: keine Kampf-Gegner im Hub
- Buchführung: 8d nach CHANGEREQUESTS_DONE, ROADMAP nachgezogen

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-20 19:43:33 +02:00

84 lines
2.4 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
## Beendet den Encounter vorzeitig (Abbruch durch die Szene).
func stop() -> void:
if not is_running:
return
is_running = false
_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)