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>
This commit is contained in:
danny 2026-07-20 19:43:33 +02:00
parent e662648522
commit b96b07b7d9
6 changed files with 493 additions and 304 deletions

View file

@ -0,0 +1,84 @@
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)

View file

@ -0,0 +1,147 @@
extends CombatActor
## Gegner mit einfacher Kampf-KI (CR 8d) — Node an einem Körper.
##
## Bewegt seinen Elternkörper Richtung Tyrveil, hält Schlagdistanz und
## fährt **sichtbar telegrafierte** Angriffe: kurzer Rückzug, Ausholen
## (Mesh färbt sich), dann der Schlag. Genau dieses Fenster ist das
## Angebot an den Spieler — ausweichen, durchrollen, blocken oder
## parieren (8a). Zwischen den Schlägen blockt er gelegentlich selbst,
## damit schwere Angriffe und Kombos einen Zweck haben (8b/8c).
## Aggression, Härte und Tempo kommen aus den Export-Werten, damit
## Sparringspartner und Hinterhalt-Schergen dieselbe Klasse mit anderen
## Zahlen nutzen können. Wird der Gegner gestaggert (Parry), steht er
## offen. Der Tod meldet nur das Signal — was daraus folgt, entscheidet
## die Encounter-Szene.
signal telegraph_started
signal strike_resolved(did_hit: bool)
const TURN_SPEED := 8.0
@export var enemy_name := "Gegner"
@export var max_hitpoints := 90
@export var strike_damage := 10
@export var strike_range := 2.4
@export var move_speed := 2.6
@export var telegraph_seconds := 0.9
@export var strike_cooldown := 1.8
@export var block_chance := 0.25
@export var block_seconds := 1.2
@export var is_active := false
var _cooldown := 0.0
var _telegraph := 0.0
var _block_timer := 0.0
var _gravity: float = ProjectSettings.get_setting("physics/3d/default_gravity")
@onready var _body: Node3D = get_parent() as Node3D
@onready var _mesh: MeshInstance3D = _body.get_node_or_null("MeshInstance3D")
## Meldet sich als Kampfziel an und setzt die Werte.
func _ready() -> void:
add_to_group("combat_actor")
max_health = max_hitpoints
max_stamina = 100.0
reset_combat_values()
_cooldown = strike_cooldown
## Schaltet die KI scharf oder ab (Encounter-Start/-Ende).
func set_active(active: bool) -> void:
is_active = active
_telegraph = 0.0
_block_timer = 0.0
_cooldown = strike_cooldown
_paint(false)
## Gegner blocken, solange ihr Block-Timer läuft.
func is_blocking() -> bool:
return _block_timer > 0.0
## Treibt Annäherung, Telegraph, Schlag und Block an.
func _physics_process(delta: float) -> void:
tick_combat(delta)
if not is_active or not is_alive() or _body == null:
return
var player := get_tree().get_first_node_in_group("player") as Node3D
if player == null or DialogueSystem.is_dialogue_active:
return
_block_timer = maxf(_block_timer - delta, 0.0)
if is_staggered():
_paint(false)
_telegraph = 0.0
return
_face(player, delta)
if _telegraph > 0.0:
_telegraph -= delta
if _telegraph <= 0.0:
_resolve_strike(player)
return
var distance := _body.global_position.distance_to(player.global_position)
if distance > strike_range:
_step_towards(player, delta)
_cooldown = maxf(_cooldown - delta, 0.0)
if _cooldown > 0.0 or distance > strike_range:
return
if randf() < block_chance:
_block_timer = block_seconds
_cooldown = block_seconds
return
_begin_telegraph()
## Geht einen Schritt auf Tyrveil zu (Greybox: direkte Bewegung, kein
## Pathfinding — die Encounter-Arenen sind offen).
func _step_towards(player: Node3D, delta: float) -> void:
var to_player := player.global_position - _body.global_position
to_player.y = 0.0
if to_player.length_squared() < 0.01:
return
_body.global_position += to_player.normalized() * move_speed * delta
## Dreht den Gegner zum Spieler.
func _face(player: Node3D, delta: float) -> void:
if _mesh == null:
return
var to_player := player.global_position - _body.global_position
to_player.y = 0.0
if to_player.length_squared() < 0.01:
return
var target_yaw := atan2(-to_player.x, -to_player.z)
_mesh.rotation.y = lerp_angle(_mesh.rotation.y, target_yaw, minf(TURN_SPEED * delta, 1.0))
## Kündigt den Schlag sichtbar an — das Fenster für Ausweichen, Rollen,
## Blocken und Parieren.
func _begin_telegraph() -> void:
_telegraph = telegraph_seconds
_paint(true)
telegraph_started.emit()
## Führt den Schlag aus, wenn Tyrveil noch in Reichweite steht.
func _resolve_strike(player: Node3D) -> void:
_paint(false)
_cooldown = strike_cooldown
if _body.global_position.distance_to(player.global_position) > strike_range + 0.4:
strike_resolved.emit(false)
return
var combat := player.get_node_or_null("PlayerCombat") as CombatActor
if combat == null:
strike_resolved.emit(false)
return
var result: String = combat.take_hit(strike_damage, false, self)
strike_resolved.emit(result == "hit")
## Färbt das Mesh während des Telegraphs.
func _paint(is_telegraphing: bool) -> void:
if _mesh == null:
return
var material := StandardMaterial3D.new()
material.albedo_color = Color(0.85, 0.35, 0.3) if is_telegraphing else Color(0.45, 0.4, 0.45)
_mesh.material_override = material