windgeschworen/scripts/gameplay/balance_qte.gd
danny cba2dfe1ec CR 20: Viadukt respawnt am Checkpoint statt am Spielstand
Der Sturz in die Nebelschlucht setzt Tyrveil jetzt am zuletzt erreichten
Checkpoint wieder ab — ohne Szenenwechsel, ohne Laden. Wurde noch keiner
beruehrt, beginnt der Lauf am Steganfang. Damit verhalten sich die beiden
Set-Pieces mit Checkpoints gleich; reload_last_save() bleibt den Story-Toden
vorbehalten, Tag-9-Hinterhalt und Dreschen-Pruefung. SPEC §6 haelt die
Checkpoint-Ausnahme jetzt fest.

Player.reset_motion() loescht beim Respawn Geschwindigkeit und Fremdschub,
damit der Sturzimpuls nicht mit auf den Steg zurueckkommt.
BalanceQTE.cancel() bricht ein noch laufendes QTE ueber einen
Generations-Zaehler ergebnislos ab — sonst haette die wartende Coroutine den
frisch abgesetzten Spieler sofort wieder heruntergestossen.

Dabei aufgefallen und nach Autoren-Entscheidung mitbehoben: Der Wind wirkte
als Beschleunigung statt als Zusatz-Geschwindigkeit. player.gd addierte
external_push pro Frame, waehrend die Abklingrechnung im Stillstand den
Windanteil des Vorframes erneut einlas — die Seitwaertsgeschwindigkeit lief
von 0 auf -21 m/s in einer Sekunde davon, bei konstantem Schub von -0,7. Der
Fehler war Altbestand und nur unsichtbar, weil der Tod bisher die Szene neu
lud; mit dem Checkpoint-Respawn haette er sofort wieder heruntergeblasen.
_process_normal() zieht den zuletzt angewandten Schub jetzt zu Frame-Beginn
ab. Gemessen danach: konstant 0,70 m/s, 1,07 m Versatz in 1,5 s. Das Viadukt
wird dadurch spuerbar gutmuetiger.

Gauntlet unveraendert.

Verifiziert mit dev_cr20_probe (19/19) und einem Boot-Check ueber acht
Szenen; Sonde vor dem Commit geloescht.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-21 18:46:48 +02:00

186 lines
5.8 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
var _run_id := 0
## 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
## Bricht ein laufendes QTE ergebnislos ab: Prompt aus, Steuerung frei,
## und die noch wartende Coroutine läuft ins Leere. Nötig beim Respawn
## (CR 20) — sonst stößt ein überlebendes QTE den gerade am Checkpoint
## abgesetzten Spieler sofort wieder vom Steg.
func cancel() -> void:
if not _is_active:
return
_run_id += 1
_is_active = false
_hide_prompt()
if _player != null:
_player.set_control_locked(false)
## 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:
_run_id += 1
var own_id := _run_id
_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 own_id != _run_id:
return
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