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

@ -1,44 +1,88 @@
extends Node3D
## Ablauf-Steuerung des Viadukt-Set-Pieces (Phase 3 + Change Requests,
## STORY.md Prolog).
## Ablauf-Steuerung des Viadukts (CR-001: buchgetreuer Umbau, STORY.md
## Prolog).
##
## Spielt beim Betreten den cineastischen Kamera-Schwenk (SPEC Abschnitt
## 2), verwaltet die Segment-Checkpoints und die KillZone unter dem Steg:
## Bei Permadeath AN führt ein Sturz zum Game Over (zurück ins
## Hauptmenü), bei Permadeath AUS zum Respawn am zuletzt erreichten
## Checkpoint. Wren läuft vor dem Spieler das Viadukt entlang und bleibt
## an der kippenden Platte stehen; holt Tyrveil ihn ein
## (WREN_TRIGGER_DISTANCE), löst das Straucheln als nicht abbrechbarer
## Dialog aus (viaduct_wren.json) — beide Optionen retten Wren, die Wahl
## landet als Story-Flag im GameState. Der Übergang am Ende ist ein
## Platzhalter Richtung Reiterquadrant.
## Buchnah nach Fourth Wing: ein schmaler Steinsteg ohne Geländer über
## einer Nebelschlucht — Absturz bedeutet Tod. Der Steg wird prozedural
## aus bridge_width/bridge_length gebaut, damit die Breite im Editor
## tunebar bleibt (0.45 m ist buchgetreu, aber brutal; Startwert 0.8 m).
## Drei eigenständige Komponenten am Szenen-Root steuern die Gefahr:
## WindController (konstanter Seitenwind + Böen), WeatherController
## (Regen-Chance verschärft Balance) und BalanceQTE (Rutsch-QTE mit
## Gegensteuern). Beim Betreten läuft der cineastische Kamera-Schwenk
## (SPEC Abschnitt 2). Wren läuft voraus und strauchelt beim Einholen
## (nicht abbrechbarer Dialog, Story-Flag viaduct_wren_rescue). Ein Sturz
## in die KillZone bedeutet bei Permadeath AN Game Over, sonst Respawn am
## letzten Checkpoint. Optionaler Vorlauf (250-Stufen-Turmaufstieg vor dem
## Steg) ist bewusst NICHT Teil dieses CR — bei Bedarf eigener CR.
const MAIN_MENU_SCENE := "res://scenes/ui/main_menu.tscn"
const WREN_DIALOGUE_PATH := "res://data/dialogue/viaduct_wren.json"
const WREN_WALK_SPEED := 1.2
const WREN_STALL_Z := -202.0
const WREN_STALL_Z := -44.0
const WREN_TRIGGER_DISTANCE := 3.5
const BRIDGE_FRONT_Z := -4.0
@export var bridge_width := 0.8
@export var bridge_length := 60.0
var _checkpoint_position := Vector3.ZERO
var _has_wren_triggered := false
var _player: CharacterBody3D
@onready var _wren: Node3D = $Wren
@onready var _wind: Node = $WindController
@onready var _weather: Node3D = $WeatherController
@onready var _qte: CanvasLayer = $BalanceQTE
## Merkt den Startpunkt als ersten Checkpoint, verbindet Checkpoints und
## KillZone und spielt den Kamera-Schwenk.
## Baut den Steg, merkt den Startpunkt als Checkpoint, verbindet
## Checkpoints und KillZone, verdrahtet Wind/Wetter/QTE und spielt den
## Kamera-Schwenk.
func _ready() -> void:
_build_bridge()
_player = get_tree().get_first_node_in_group("player")
if _player != null:
_checkpoint_position = _player.global_position
_player.play_camera_pan()
for checkpoint in $Checkpoints.get_children():
checkpoint.body_entered.connect(_on_checkpoint_entered.bind(checkpoint))
$KillZone.body_entered.connect(_on_kill_zone_entered)
if _player == null:
return
_checkpoint_position = _player.global_position
var bridge_end_z := BRIDGE_FRONT_Z - bridge_length
_wind.setup(_player, BRIDGE_FRONT_Z + 1.0, bridge_end_z - 1.0)
_weather.setup(_player)
_qte.setup(_player, _weather, bridge_width)
_qte.connect_wind(_wind)
_weather.roll_weather()
_player.play_camera_pan()
## Lässt Wren das Viadukt entlanggehen, bis er an der kippenden Platte
## Erzeugt die schmale Steg-Geometrie (Kollision + Mesh) prozedural aus
## bridge_width/bridge_length, damit die Breite tunebar bleibt.
func _build_bridge() -> void:
var center_z := BRIDGE_FRONT_Z - bridge_length / 2.0
var body := StaticBody3D.new()
body.name = "BridgeSpan"
body.position = Vector3(0.0, -0.5, center_z)
var shape := CollisionShape3D.new()
shape.name = "CollisionShape3D"
var box := BoxShape3D.new()
box.size = Vector3(bridge_width, 1.0, bridge_length)
shape.shape = box
body.add_child(shape)
var mesh_instance := MeshInstance3D.new()
mesh_instance.name = "MeshInstance3D"
var box_mesh := BoxMesh.new()
box_mesh.size = Vector3(bridge_width, 1.0, bridge_length)
var material := StandardMaterial3D.new()
material.albedo_color = Color(0.45, 0.44, 0.42)
box_mesh.material = material
mesh_instance.mesh = box_mesh
body.add_child(mesh_instance)
$Bridge.add_child(body)
## Lässt Wren den Steg entlanggehen, bis er an der schwankenden Stelle
## stehen bleibt, und löst das Straucheln aus, sobald Tyrveil ihn einholt.
func _physics_process(delta: float) -> void:
if _has_wren_triggered or _player == null:
@ -55,15 +99,15 @@ func _physics_process(delta: float) -> void:
})
## Setzt den Respawn-Punkt auf den erreichten Segment-Checkpoint.
## Setzt den Respawn-Punkt auf den erreichten Checkpoint.
func _on_checkpoint_entered(body: Node3D, checkpoint: Area3D) -> void:
if not body.is_in_group("player"):
return
_checkpoint_position = Vector3(checkpoint.global_position.x, 0.1, checkpoint.global_position.z)
## Sturz in den Abgrund: Game Over bei Permadeath AN, sonst Respawn am
## letzten Checkpoint.
## Sturz in die Nebelschlucht: Game Over bei Permadeath AN, sonst Respawn
## am letzten Checkpoint (bestehende Death/Respawn-Logik).
func _on_kill_zone_entered(body: Node3D) -> void:
if not body.is_in_group("player"):
return
@ -72,5 +116,6 @@ func _on_kill_zone_entered(body: Node3D) -> void:
Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
get_tree().change_scene_to_file.call_deferred(MAIN_MENU_SCENE)
return
body.external_push = Vector3.ZERO
body.velocity = Vector3.ZERO
body.global_position = _checkpoint_position