windgeschworen/scripts/gameplay/sparring_fight.gd
danny 80329070ec CR 5: Tyrveil ins Vierte Geschwader / Violets Staffel
- data/story/staffel.json: Aufstellung (Viertes Geschwader, Zweite
  Staffel, Staffelführer Dain, Kameraden Violet/Rhiannon/Ridoc/Sawyer/
  Liam); StorySystem lädt sie (get_staffel, get_staffel_partner)
- Ankunfts-Sequenz liest die Aufstellung sichtbar vor (daten-getrieben)
- Sparring-Paarungen ziehen pro Kampf einen Staffel-Namen (NPC-Label +
  HUD-Balken); Staffel-Ansehen bleibt an Fraktion „staffel" gekoppelt
- Buchführung: CR 5 nach CHANGEREQUESTS_DONE, ROADMAP nachgezogen

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-19 18:14:41 +02:00

279 lines
9.6 KiB
GDScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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: 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
var _partner_name := "Sparringspartner"
@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.
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
_draw_partner()
_ensure_hud()
_update_hud()
_hud.visible = true
_state = FightState.FIGHTING
## Zieht die heutige Sparring-Paarung aus der Staffel-Liste (CR 5) und
## beschriftet Gegner-Label und HUD-Balken mit dem Namen.
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
## 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), _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
## 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