windgeschworen/scripts/gameplay/balance_qte.gd
danny 1d8d3bc342 CR-001: Viadukt buchgetreu (Schmalsteg + Wind/Regen/Balance-QTE), Abspann-Fix
- Viadukt zu schmalem, gelaenderlosem Steinsteg ueber Nebelschlucht
  umgebaut: Steg prozedural aus bridge_width (Export, Default 0.8 m,
  tunebar) + bridge_length; WorldEnvironment-Nebel, breite KillZone fuer
  Stuerze zu beiden Seiten; altes 220-m-Parcours ersetzt
- Drei signalbasierte Komponenten am Szenen-Root:
  wind_controller (konstanter Seitenwind + Boeen, schiebt ueber neues
  player.external_push; ruht bei Dialog/Pan/abseits), weather_controller
  (rain_chance, Regenpartikel folgen Spieler, verschaerft Balance),
  balance_qte (Rutsch-Wurf pro Boe, Steuerung friert ein = lokale
  Slow-Motion ohne globales time_scale, Gegensteuer-Prompt A/Stick links
  bzw. D/Stick rechts, Reaktionsfenster, qte_tap_count; Fehlschlag stoesst
  vom Steg in die KillZone -> bestehende Death/Respawn-Logik)
- alle Tuning-Werte als @export; Signale slip_triggered/qte_succeeded/
  qte_failed/gust_started/rain_started; Wren-Moment (nicht abbrechbar)
  bleibt, loest beim Einholen aus; 250-Stufen-Turm bewusst ausgelassen
- player.gd: external_push wird vor move_and_slide addiert,
  is_control_locked() als oeffentliche Abfrage
- Abspann-Fix: Epilog-Endscreen in CenterContainer -> sauber zentriert
  statt in der Ecke
- Headless verifiziert (27 Checks): Geometrie/Nebel, Wind nur auf dem
  Steg, forcierter Regen, QTE-Erfolg/-Fehlschlag+Respawn, Wren-Moment,
  zentrierter Abspann

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

167 lines
5.3 KiB
GDScript

extends CanvasLayer
## Rutsch-QTE des Viadukts (CR-001).
##
## Lauscht auf die Böen des WindControllers. Pro Bö wird mit
## slip_chance = slip_base_chance * gust_factor * rain_factor gewürfelt, ob
## der Spieler ins Rutschen gerät. Beim Rutschen friert die Steuerung ein
## (greybox-Realisierung des Slow-Motion-Moments — bewusst KEIN globales
## Engine.time_scale, das den Rest bräche: der Spieler steht still und
## konzentriert sich auf das Gegensteuern), ein Prompt zeigt die
## Gegensteuer-Taste, und der Spieler muss innerhalb von qte_window in die
## Gegenrichtung drücken (A/move_left bzw. D/move_right — Tastatur wie
## linker Stick, da an dieselben Actions gebunden). Bei stärkeren Böen sind
## über qte_tap_count mehrere abwechselnde Taps nötig. Erfolg: der
## Charakter fängt sich. Fehlschlag (falsche Taste oder zu spät): der
## Spieler wird vom schmalen Steg gestoßen und stürzt in die KillZone — die
## bestehende Death/Respawn-Logik des Viadukts übernimmt.
signal slip_triggered(direction: int)
signal qte_succeeded
signal qte_failed
const GUST_REFERENCE := 2.75
@export var slip_base_chance := 0.55
@export var qte_window := 0.9
@export var qte_tap_count := 1
@export var bridge_width := 0.8
@export var fall_push := 1.2
var _player: CharacterBody3D
var _weather: Node
var _is_active := false
var _last_input_dir := 0
var _label: Label
## Verknüpft Spieler, Wetter-Controller und Steg-Breite und baut den
## Prompt auf.
func setup(player: CharacterBody3D, weather: Node, width: float) -> void:
_player = player
_weather = weather
bridge_width = width
_build_ui()
## Verbindet die Böen des WindControllers mit dem Rutsch-Wurf.
func connect_wind(wind: Node) -> void:
wind.gust_started.connect(_on_gust_started)
## Meldet, ob gerade ein QTE läuft (auch für Tests).
func is_active() -> bool:
return _is_active
## Zeichnet während eines aktiven QTE die zuletzt gedrückte Seitenrichtung
## auf; der Player ist dann gesperrt, sodass die Eingabe hier ankommt.
func _unhandled_input(event: InputEvent) -> void:
if not _is_active:
return
if event.is_action_pressed("move_left"):
_last_input_dir = -1
elif event.is_action_pressed("move_right"):
_last_input_dir = 1
## Würfelt bei einer Bö, ob der Spieler rutscht, und startet dann das QTE.
func _on_gust_started(direction: int, strength_mult: float) -> void:
if _is_active or _player == null:
return
if DialogueSystem.is_dialogue_active or _player.is_control_locked():
return
var rain_factor := 1.0
if _weather != null:
rain_factor = _weather.slip_multiplier()
var slip := clampf(slip_base_chance * (strength_mult / GUST_REFERENCE) * rain_factor, 0.0, 0.95)
if randf() > slip:
return
_run_qte(direction)
## Spielt das QTE als Coroutine ab: Steuerung sperren, je Tap die
## Gegensteuer-Taste anzeigen und im Zeitfenster abfragen, dann auflösen.
func _run_qte(slip_dir: int) -> void:
_is_active = true
slip_triggered.emit(slip_dir)
_player.set_control_locked(true)
var window := qte_window
if _weather != null:
window *= _weather.window_multiplier()
var counter := -slip_dir
var taps: int = maxi(qte_tap_count, 1)
for i in taps:
_last_input_dir = 0
_show_prompt(counter)
var is_ok := await _await_tap(counter, window)
if not is_ok:
_fail(slip_dir)
return
counter = -counter
_succeed()
## Wartet innerhalb des Fensters auf den korrekten Gegensteuer-Tap; die
## falsche Richtung scheitert sofort, Ablauf des Fensters ebenfalls.
func _await_tap(expected: int, window: float) -> bool:
var start := Time.get_ticks_msec()
while float(Time.get_ticks_msec() - start) / 1000.0 < window:
if _last_input_dir == expected:
return true
if _last_input_dir == -expected:
return false
await get_tree().physics_frame
return false
## Erfolg: Prompt aus, Steuerung frei, der Charakter fängt sich.
func _succeed() -> void:
_hide_prompt()
_is_active = false
_player.set_control_locked(false)
qte_succeeded.emit()
## Fehlschlag: Prompt aus, Steuerung frei, und der Spieler wird über die
## schmale Stegkante gestoßen — er fällt in die KillZone, die die
## bestehende Death/Respawn-Logik auslöst.
func _fail(slip_dir: int) -> void:
_hide_prompt()
_is_active = false
_player.set_control_locked(false)
qte_failed.emit()
_player.external_push = Vector3.ZERO
_player.velocity = Vector3.ZERO
_player.global_position.x += float(slip_dir) * (bridge_width * 0.5 + fall_push)
## Baut die zentrierte Prompt-Anzeige (versteckt).
func _build_ui() -> void:
layer = 3
var root := Control.new()
root.set_anchors_preset(Control.PRESET_FULL_RECT)
root.mouse_filter = Control.MOUSE_FILTER_IGNORE
_label = Label.new()
_label.set_anchors_preset(Control.PRESET_CENTER)
_label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
_label.add_theme_font_size_override("font_size", 40)
_label.add_theme_color_override("font_color", Color(1, 0.85, 0.4))
_label.add_theme_color_override("font_outline_color", Color.BLACK)
_label.add_theme_constant_override("outline_size", 8)
_label.visible = false
root.add_child(_label)
add_child(root)
## Zeigt die Gegensteuer-Aufforderung mit Tastatur- und Controller-Hinweis.
func _show_prompt(counter: int) -> void:
if counter < 0:
_label.text = "◄ GEGENSTEUERN — A / Stick links"
else:
_label.text = "GEGENSTEUERN ► — D / Stick rechts"
_label.visible = true
## Blendet die Prompt-Anzeige aus.
func _hide_prompt() -> void:
_label.visible = false