CRs: Sparring-Kampfsystem (HP/Ausdauer/Block) + Sparringhalle & Kartenraum

- Actions attack (Linksklick/R2) und block (Rechtsklick/Quadrat-X), SPEC 9
- sparring_fight.gd: Echtzeit-Duell mit Gegner-HP 20 (3-5 Treffer je nach
  Kraft), Telegraph-Block (Fenster skaliert mit Schnelligkeit), Ausdauer
  mit Guard-Break und schwachen Schlaegen, interner Gegner-Ausdauer als
  Taktgeber, HUD mit drei Balken; nie toedlich, Sieg/Niederlage muenden in
  die bestehenden Klinge/Herz-Dialoge mit Ton- und Standing-Effekten
- Neue Raeume: sparring_hall.tscn (Ring, Sparringspartner, Kampftraining)
  und map_room.tscn (Kartentisch, Landnavigation); Aussen-Stationen aus dem
  Quadranten entfernt, Zonen-Trigger + Spawns beidseitig
- Headless verifiziert (26 Checks): Uebergaenge, Slot-Verbrauch,
  Schadens-Skalierung, Ausdauer, Block+Stagger, Niederlage ohne Tod bei
  Permadeath AN, Ton-/Standing-Effekte beider Ausgaenge

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-06 17:15:07 +02:00
parent 5eb46577b9
commit 7a4ed2d6dc
11 changed files with 852 additions and 231 deletions

View file

@ -0,0 +1,264 @@
extends StaticBody3D
## Echtes Sparring-Kampfsystem (Change Request + SPEC.md Roadmap Phase 4:
## stat-basiertes, taktisches Sparring).
##
## 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, unabhängig vom Permadeath-Toggle: Sieg führt
## in den Klinge/Herz-Abschluss (sparring_win.json — Gegner überwältigt:
## fertigmachen oder aufhelfen), Niederlage in sparring_loss.json.
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 INPUT_COOLDOWN_MS := 800
@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_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
@onready var _prompt_label: Label3D = $PromptLabel
@onready var _interaction_area: Area3D = $InteractionArea
@onready var _bubble: Node3D = $SpeechBubble
@onready var _mesh: MeshInstance3D = $MeshInstance3D
## Verbindet die Reichweiten-Signale des Interaktions-Triggers.
func _ready() -> void:
_interaction_area.body_entered.connect(_on_body_entered)
_interaction_area.body_exited.connect(_on_body_exited)
## Startet den Kampf per interact bzw. wertet Schläge während des Kampfes.
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:
return
if DialogueSystem.is_dialogue_active:
return
if not event.is_action_pressed("interact"):
return
if Time.get_ticks_msec() - _last_use_ms < INPUT_COOLDOWN_MS:
return
_last_use_ms = Time.get_ticks_msec()
_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:
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
_ensure_hud()
_update_hud()
_hud.visible = true
_state = FightState.FIGHTING
## 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
var player := get_tree().get_first_node_in_group("player")
if player != null:
player.set_control_locked(false)
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), "Sparringspartner", 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
## Blendet den Prompt aus, wenn der Spieler die Reichweite verlässt.
func _on_body_exited(_body: Node3D) -> void:
_is_player_in_range = false
_prompt_label.visible = false

View file

@ -0,0 +1 @@
uid://dokrernqagk1x

View file

@ -1,79 +0,0 @@
extends StaticBody3D
## Sparring-Station im Reiterquadranten (Phase 4b, SPEC.md Roadmap
## Phase 4: stat-basiertes, taktisches Sparring).
##
## Interaktion wie bei den Unterrichts-Stationen; jede Runde verbraucht
## einen Tages-Slot (TimeSystem.try_spend_slot). Der Ausgang hängt an
## einem Stat-Check gegen einen erfahrenen Zweitjahr-Kadetten: Sieg bei
## Kraft >= STRENGTH_THRESHOLD ODER Schnelligkeit >= AGILITY_THRESHOLD
## (je 40 — mit den Startwerten 35/35 verliert man zunächst und muss über
## das Training aus Phase 4a wachsen). Sieg wie Niederlage laufen als
## Dialog mit taktischem Klinge/Herz-Entscheidungspunkt; die Optionen
## verschieben Klinge-↔-Herz-Ton und das Gezeichneten-Standing
## (faction_standing-Tag, erster Story-Verbraucher des FactionSystems).
const STRENGTH_THRESHOLD := 40
const AGILITY_THRESHOLD := 40
const INPUT_COOLDOWN_MS := 800
@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 _is_player_in_range := false
var _last_use_ms := -INPUT_COOLDOWN_MS
@onready var _prompt_label: Label3D = $PromptLabel
@onready var _interaction_area: Area3D = $InteractionArea
@onready var _bubble: Node3D = $SpeechBubble
## Verbindet die Reichweiten-Signale des Interaktions-Triggers.
func _ready() -> void:
_interaction_area.body_entered.connect(_on_body_entered)
_interaction_area.body_exited.connect(_on_body_exited)
## Startet die Sparringrunde bei interact in Reichweite, außerhalb
## laufender Dialoge und nach Ablauf des Doppel-Eingabe-Schutzes.
func _unhandled_input(event: InputEvent) -> void:
if not _is_player_in_range:
return
if DialogueSystem.is_dialogue_active:
return
if not event.is_action_pressed("interact"):
return
if Time.get_ticks_msec() - _last_use_ms < INPUT_COOLDOWN_MS:
return
_last_use_ms = Time.get_ticks_msec()
_spar()
## Verbraucht den Tages-Slot und startet je nach Stat-Check den Sieg-
## oder Niederlage-Dialog.
func _spar() -> void:
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
var is_winning := GameState.strength >= STRENGTH_THRESHOLD or GameState.agility >= AGILITY_THRESHOLD
var dialogue_path := win_dialogue_path if is_winning else loss_dialogue_path
DialogueSystem.start_dialogue(dialogue_path, {
"sparring": self,
DialogueSystem.PLAYER_SPEAKER_ID: player,
})
## 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 = true
## Blendet den Prompt aus, wenn der Spieler die Reichweite verlässt.
func _on_body_exited(_body: Node3D) -> void:
_is_player_in_range = false
_prompt_label.visible = false

View file

@ -1 +0,0 @@
uid://b0bt7s51qbdj