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)