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

@ -1,87 +1,67 @@
extends StaticBody3D
## Echtes Sparring-Kampfsystem (Change Request + SPEC.md Roadmap Phase 4:
## stat-basiertes, taktisches Sparring).
## Sparring auf dem echten Kampfsystem (CR 8d — ersetzt das alte
## Timing-Duell; SPEC.md §1/§5.1, Roadmap Phase 4).
##
## Interact startet den Kampf und verbraucht einen Tages-Slot. Linksklick
## bzw. R2 schlägt (attack), Rechtsklick bzw. ▢/Ⓧ blockt (block). Kraft
## skaliert den Schaden pro Treffer: BASE_DAMAGE + 1 je volle 10 Kraft
## über 30 — der Gegner fällt also je nach Training in 3–5 Treffern.
## Schnelligkeit weitet das Block-Fenster (Telegraph-Dauer des Gegners).
## Ausdauer Tyrveils: Schlagen kostet ATTACK_COST, erfolgreiches Blocken
## BLOCK_COST, Regeneration STAMINA_REGEN pro Sekunde; unter
## GUARD_BREAK_THRESHOLD ist kein Block möglich (Guard-Break), unter
## WEAK_ATTACK_THRESHOLD halbiert sich der Schlagschaden. Der Gegner hat
## eine interne Ausdauer OHNE sichtbaren Balken, die sein Angriffstempo
## steuert (Angriff nur bei genug Ausdauer). HUD: HP-Balken beider
## Kämpfer plus Ausdauer-Balken Tyrveils (Laufzeit-CanvasLayer).
## Sparring ist nie tödlich: Sieg führt
## in den Klinge/Herz-Abschluss (sparring_win.json — Gegner überwältigt:
## fertigmachen oder aufhelfen), Niederlage in sparring_loss.json.
## Interact startet die Übungsrunde und verbraucht einen Tages-Slot.
## Danach läuft ein **echter Encounter** (CombatEncounter): Tyrveil
## bewegt sich frei, schlägt leicht und schwer, weicht aus, rollt,
## blockt und pariert (8a), wechselt die Waffe (8b) und kettet Kombos
## (8c); der Partner ist ein EnemyCombatant mit telegrafierten
## Schlägen. Der Gegner wird als Kind-Knoten zur Laufzeit angelegt, die
## Szene muss nichts vorbereiten.
##
## Sparring ist **nie tödlich** (SPEC §6): Fällt Tyrveil, endet die
## Runde als Niederlage mit sparring_loss.json statt mit einem Tod —
## der CR-16-Respawn greift hier bewusst nicht. Sieg führt in die
## Klinge/Herz-Weiche (sparring_win.json). Die Paarung zieht ihren Namen
## weiterhin aus Tyrveils Staffel (CR 5).
enum FightState { WAITING, FIGHTING, RESOLVING }
const PLAYER_MAX_HP := 5
const ENEMY_MAX_HP := 20
const BASE_DAMAGE := 4
const STAMINA_MAX := 100.0
const ATTACK_COST := 20.0
const BLOCK_COST := 15.0
const STAMINA_REGEN := 25.0
const GUARD_BREAK_THRESHOLD := 15.0
const WEAK_ATTACK_THRESHOLD := 20.0
const ENEMY_STAMINA_MAX := 100.0
const ENEMY_ATTACK_COST := 30.0
const ENEMY_STAMINA_REGEN := 20.0
const ENEMY_STRIKE_COOLDOWN := 1.2
const ENEMY_STAGGER_SECONDS := 1.0
const PLAYER_ATTACK_COOLDOWN := 0.5
const TELEGRAPH_SCALE := 1.18
const ENEMY_SCRIPT := preload("res://scripts/gameplay/combat/enemy_combatant.gd")
const ENCOUNTER_SCRIPT := preload("res://scripts/gameplay/combat/combat_encounter.gd")
const INPUT_COOLDOWN_MS := 800
const PARTNER_HITPOINTS := 90
const PARTNER_DAMAGE := 9
@export_file("*.json") var win_dialogue_path := "res://data/dialogue/sparring_win.json"
@export_file("*.json") var loss_dialogue_path := "res://data/dialogue/sparring_loss.json"
@export var exhausted_line := "Für heute reicht es — der Schlafsaal wartet."
var _state := FightState.WAITING
var _player_hp := PLAYER_MAX_HP
var _enemy_hp := ENEMY_MAX_HP
var _stamina := STAMINA_MAX
var _enemy_stamina := ENEMY_STAMINA_MAX
var _attack_cooldown := 0.0
var _enemy_cooldown := 0.0
var _telegraph_remaining := 0.0
var _stagger_remaining := 0.0
var _is_enemy_telegraphing := false
var is_fighting := false
var _is_player_in_range := false
var _last_use_ms := -INPUT_COOLDOWN_MS
var _hud: CanvasLayer
var _player_hp_bar: ProgressBar
var _stamina_bar: ProgressBar
var _enemy_hp_bar: ProgressBar
var _partner_name := "Sparringspartner"
var _home_position := Vector3.ZERO
var _enemy: CombatActor
var _encounter: CombatEncounter
@onready var _prompt_label: Label3D = $PromptLabel
@onready var _interaction_area: Area3D = $InteractionArea
@onready var _bubble: Node3D = $SpeechBubble
@onready var _mesh: MeshInstance3D = $MeshInstance3D
@onready var _name_label: Label3D = $NameLabel
## Verbindet die Reichweiten-Signale des Interaktions-Triggers.
## Legt Gegner-Knoten und Encounter-Rahmen an und verbindet die
## Reichweiten-Signale.
func _ready() -> void:
_home_position = global_position
_interaction_area.body_entered.connect(_on_body_entered)
_interaction_area.body_exited.connect(_on_body_exited)
_enemy = ENEMY_SCRIPT.new()
_enemy.name = "PartnerCombat"
_enemy.enemy_name = _partner_name
_enemy.max_hitpoints = PARTNER_HITPOINTS
_enemy.strike_damage = PARTNER_DAMAGE
add_child(_enemy)
_encounter = ENCOUNTER_SCRIPT.new()
_encounter.name = "SparringEncounter"
add_child(_encounter)
_encounter.finished.connect(_on_encounter_finished)
## Startet den Kampf per interact bzw. wertet Schläge während des Kampfes.
## Startet die Übungsrunde per interact in Reichweite.
func _unhandled_input(event: InputEvent) -> void:
if _state == FightState.FIGHTING:
if event.is_action_pressed("attack"):
_player_attack()
get_viewport().set_input_as_handled()
return
if _state != FightState.WAITING or not _is_player_in_range:
if is_fighting or not _is_player_in_range:
return
if DialogueSystem.is_dialogue_active:
return
@ -90,187 +70,56 @@ func _unhandled_input(event: InputEvent) -> void:
if Time.get_ticks_msec() - _last_use_ms < INPUT_COOLDOWN_MS:
return
_last_use_ms = Time.get_ticks_msec()
_try_start_fight()
try_start_fight()
## Treibt Ausdauer-Regeneration, Cooldowns und die Gegner-KI an.
func _physics_process(delta: float) -> void:
if _state != FightState.FIGHTING:
return
_stamina = minf(_stamina + STAMINA_REGEN * delta, STAMINA_MAX)
_enemy_stamina = minf(_enemy_stamina + ENEMY_STAMINA_REGEN * delta, ENEMY_STAMINA_MAX)
_attack_cooldown = maxf(_attack_cooldown - delta, 0.0)
if _is_enemy_telegraphing:
_telegraph_remaining -= delta
if _telegraph_remaining <= 0.0:
_resolve_enemy_strike()
elif _stagger_remaining > 0.0:
_stagger_remaining -= delta
else:
_enemy_cooldown = maxf(_enemy_cooldown - delta, 0.0)
if _enemy_cooldown <= 0.0 and _enemy_stamina >= ENEMY_ATTACK_COST:
_begin_enemy_telegraph()
_update_hud()
## Startet den Kampf: verbraucht den Tages-Slot, initialisiert Werte,
## sperrt die Bewegung und blendet das HUD ein.
func _try_start_fight() -> void:
## Verbraucht den Tages-Slot und startet den Encounter; liefert false,
## wenn der Slot schon weg ist oder kein Spieler da ist.
func try_start_fight() -> bool:
if is_fighting:
return false
if not TimeSystem.try_spend_slot():
_bubble.show_line(exhausted_line)
return
var player := get_tree().get_first_node_in_group("player")
if player == null:
push_warning("Kein Spieler für das Sparring gefunden.")
return
_player_hp = PLAYER_MAX_HP
_enemy_hp = ENEMY_MAX_HP
_stamina = STAMINA_MAX
_enemy_stamina = ENEMY_STAMINA_MAX
_attack_cooldown = 0.0
_enemy_cooldown = ENEMY_STRIKE_COOLDOWN
_is_enemy_telegraphing = false
_stagger_remaining = 0.0
player.set_control_locked(true)
_prompt_label.visible = false
return false
_draw_partner()
_ensure_hud()
_update_hud()
_hud.visible = true
_state = FightState.FIGHTING
_enemy.reset_combat_values()
global_position = _home_position
if not _encounter.start([_enemy]):
return false
is_fighting = true
_prompt_label.visible = false
return true
## Zieht die heutige Sparring-Paarung aus der Staffel-Liste (CR 5) und
## beschriftet Gegner-Label und HUD-Balken mit dem Namen.
## Zieht die heutige Sparring-Paarung aus der Staffel-Liste (CR 5).
func _draw_partner() -> void:
_partner_name = StorySystem.get_staffel_partner()
_name_label.text = _partner_name
if _enemy_hp_bar != null:
var label := _enemy_hp_bar.get_parent().get_child(0) as Label
if label != null:
label.text = _partner_name
_enemy.enemy_name = _partner_name
## Führt einen Schlag aus: Kraft bestimmt den Schaden, knappe Ausdauer
## halbiert ihn (schwache Schläge), Treffer reduzieren die Gegner-HP.
func _player_attack() -> void:
if _attack_cooldown > 0.0:
return
_attack_cooldown = PLAYER_ATTACK_COOLDOWN
var damage := maxi(1, BASE_DAMAGE + (GameState.strength - 30) / 10)
if _stamina < WEAK_ATTACK_THRESHOLD:
damage = maxi(1, damage / 2)
_stamina = maxf(_stamina - ATTACK_COST, 0.0)
_enemy_hp = maxi(_enemy_hp - damage, 0)
_update_hud()
if _enemy_hp <= 0:
_end_fight(true)
## Beginnt den Angriffs-Telegraph des Gegners; die Dauer ist zugleich das
## Block-Fenster und wächst mit Tyrveils Schnelligkeit.
func _begin_enemy_telegraph() -> void:
_enemy_stamina -= ENEMY_ATTACK_COST
_is_enemy_telegraphing = true
_telegraph_remaining = clampf(0.5 + (GameState.agility - 35) * 0.015, 0.4, 0.9)
_mesh.scale = Vector3.ONE * TELEGRAPH_SCALE
## Löst den Schlag des Gegners aus: Wird gerade geblockt (block gehalten
## und genug Ausdauer), taumelt der Gegner; sonst verliert Tyrveil einen
## Trefferpunkt.
func _resolve_enemy_strike() -> void:
_is_enemy_telegraphing = false
_mesh.scale = Vector3.ONE
_enemy_cooldown = ENEMY_STRIKE_COOLDOWN
if Input.is_action_pressed("block") and _stamina >= GUARD_BREAK_THRESHOLD:
_stamina = maxf(_stamina - BLOCK_COST, 0.0)
_stagger_remaining = ENEMY_STAGGER_SECONDS
_update_hud()
return
_player_hp = maxi(_player_hp - 1, 0)
_update_hud()
if _player_hp <= 0:
_end_fight(false)
## Beendet den Kampf und führt in den passenden Abschluss-Dialog; danach
## ist die Station für den nächsten Slot wieder bereit. Nie tödlich.
func _end_fight(is_won: bool) -> void:
_state = FightState.RESOLVING
_hud.visible = false
_mesh.scale = Vector3.ONE
## Wertet den Ausgang aus: Sieg oder Niederlage führen in den passenden
## Abschluss-Dialog. Nie tödlich — Tyrveil steht danach wieder auf.
func _on_encounter_finished(is_won: bool) -> void:
is_fighting = false
var player := get_tree().get_first_node_in_group("player")
if player != null:
player.set_control_locked(false)
var combat := player.get_node_or_null("PlayerCombat") as CombatActor
if combat != null:
combat.reset_combat_values()
global_position = _home_position
DialogueSystem.start_dialogue(win_dialogue_path if is_won else loss_dialogue_path, {
"sparring": self,
DialogueSystem.PLAYER_SPEAKER_ID: player,
})
await DialogueSystem.dialogue_finished
_state = FightState.WAITING
_prompt_label.visible = _is_player_in_range
## Baut das Kampf-HUD (HP beider Kämpfer, Ausdauer Tyrveils) beim ersten
## Bedarf.
func _ensure_hud() -> void:
if _hud != null:
return
_hud = CanvasLayer.new()
_hud.layer = 3
var root := Control.new()
root.set_anchors_preset(Control.PRESET_FULL_RECT)
root.mouse_filter = Control.MOUSE_FILTER_IGNORE
_enemy_hp_bar = _build_bar(root, Vector2(-150, 24), Color(0.75, 0.3, 0.3), _partner_name, ENEMY_MAX_HP)
_player_hp_bar = _build_bar(root, Vector2(-320, -80), Color(0.35, 0.65, 0.35), "Tyrveil", PLAYER_MAX_HP)
_stamina_bar = _build_bar(root, Vector2(-320, -46), Color(0.85, 0.75, 0.35), "Ausdauer", int(STAMINA_MAX))
_hud.add_child(root)
add_child(_hud)
_hud.visible = false
## Erzeugt einen beschrifteten Balken; offset relativ zur Ankerkante
## (negative y-Werte hängen an der Unterkante).
func _build_bar(root: Control, offset: Vector2, color: Color, label_text: String, max_value: int) -> ProgressBar:
var container := VBoxContainer.new()
if offset.y < 0.0:
container.set_anchors_preset(Control.PRESET_BOTTOM_LEFT)
container.position = Vector2(24, 0)
container.offset_top = offset.y
container.offset_left = 24.0
else:
container.set_anchors_preset(Control.PRESET_CENTER_TOP)
container.offset_left = offset.x
container.offset_top = offset.y
var label := Label.new()
label.text = label_text
label.add_theme_font_size_override("font_size", 14)
container.add_child(label)
var bar := ProgressBar.new()
bar.custom_minimum_size = Vector2(300, 18)
bar.max_value = max_value
bar.value = max_value
bar.show_percentage = false
bar.modulate = color
container.add_child(bar)
root.add_child(container)
return bar
## Spiegelt die Kampfwerte in die HUD-Balken.
func _update_hud() -> void:
if _hud == null:
return
_player_hp_bar.value = _player_hp
_stamina_bar.value = _stamina
_enemy_hp_bar.value = _enemy_hp
## Blendet den Prompt ein, sobald der Spieler die Reichweite betritt.
func _on_body_entered(_body: Node3D) -> void:
_is_player_in_range = true
_prompt_label.visible = _state == FightState.WAITING
_prompt_label.visible = not is_fighting
## Blendet den Prompt aus, wenn der Spieler die Reichweite verlässt.