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

147 lines
4.6 KiB
GDScript

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