windgeschworen/scripts/gameplay/viaduct.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

121 lines
4.7 KiB
GDScript

extends Node3D
## Ablauf-Steuerung des Viadukts (CR-001: buchgetreuer Umbau, STORY.md
## Prolog).
##
## 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 := -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
## 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")
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()
## 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:
return
if _wren.global_position.z > WREN_STALL_Z:
_wren.global_position.z -= WREN_WALK_SPEED * delta
if DialogueSystem.is_dialogue_active:
return
if _player.global_position.distance_to(_wren.global_position) <= WREN_TRIGGER_DISTANCE:
_has_wren_triggered = true
DialogueSystem.start_dialogue(WREN_DIALOGUE_PATH, {
"wren": _wren,
DialogueSystem.PLAYER_SPEAKER_ID: _player,
})
## 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 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
if GameState.is_permadeath_enabled:
print("Game Over — das Viadukt fordert seinen Preis.")
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