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>
This commit is contained in:
danny 2026-07-07 19:12:21 +02:00
parent 01f50f3107
commit 1d8d3bc342
11 changed files with 474 additions and 428 deletions

View file

@ -0,0 +1,80 @@
extends Node
## Seitenwind-System des Viadukts (CR-001).
##
## Übt eine konstante seitliche Grundkraft auf den Spieler aus, solange er
## auf dem Steg ist, und löst in Intervallen Böen aus. Der Wind schiebt
## über player.external_push (eine Zusatz-Geschwindigkeit, die der Player-
## Controller vor move_and_slide addiert). Während Dialogen, Kamera-
## Schwenk oder abseits des Stegs ruht der Wind. Die Böen melden sich per
## gust_started an das Balance-QTE. Alle Werte sind im Editor tunebar.
signal gust_started(direction: int, strength_mult: float)
signal gust_ended
@export var base_wind_force := 0.7
@export var gust_strength_mult := 2.75
@export var gust_interval_min := 3.0
@export var gust_interval_max := 6.0
@export var gust_duration := 1.2
var _player: CharacterBody3D
var _start_z := 0.0
var _end_z := 0.0
var _base_dir := 1
var _gust_timer := 0.0
var _gust_remaining := 0.0
var _gust_dir := 1
var _is_gusting := false
## Verknüpft Spieler und Steg-Grenzen (z-Bereich, in dem der Wind wirkt)
## und würfelt Grundrichtung sowie erstes Bö-Intervall.
func setup(player: CharacterBody3D, start_z: float, end_z: float) -> void:
_player = player
_start_z = start_z
_end_z = end_z
_gust_timer = randf_range(gust_interval_min, gust_interval_max)
_base_dir = 1 if randf() < 0.5 else -1
## Gibt zurück, ob gerade eine Bö aktiv ist.
func is_gusting() -> bool:
return _is_gusting
## Wendet Grund- und Bö-Kraft an und steuert die Bö-Intervalle; abseits
## des Stegs oder bei gesperrter Steuerung ruht der Wind.
func _physics_process(delta: float) -> void:
if _player == null:
return
if not _is_on_bridge() or DialogueSystem.is_dialogue_active or _player.is_control_locked():
_player.external_push = Vector3.ZERO
return
var force := base_wind_force * float(_base_dir)
if _is_gusting:
force = base_wind_force * gust_strength_mult * float(_gust_dir)
_gust_remaining -= delta
if _gust_remaining <= 0.0:
_is_gusting = false
gust_ended.emit()
else:
_gust_timer -= delta
if _gust_timer <= 0.0:
trigger_gust(_base_dir if randf() < 0.7 else -_base_dir)
_gust_timer = randf_range(gust_interval_min, gust_interval_max)
_player.external_push = Vector3(force, 0.0, 0.0)
## Löst sofort eine Bö in die angegebene Richtung aus (öffentlich, damit
## Skript und Tests sie deterministisch anstoßen können).
func trigger_gust(direction: int) -> void:
_gust_dir = direction
_is_gusting = true
_gust_remaining = gust_duration
gust_started.emit(direction, gust_strength_mult)
## Prüft, ob der Spieler im Wind-wirksamen z-Bereich des Stegs steht.
func _is_on_bridge() -> bool:
var z := _player.global_position.z
return z <= _start_z and z >= _end_z