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

136 lines
5.2 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 ist der Tod und setzt Tyrveil am zuletzt erreichten
## Checkpoint wieder ab — ohne Szenenwechsel, ohne Laden (CR 20). Damit
## verhalten sich die beiden Set-Pieces mit Checkpoints, Viadukt und
## Gauntlet, gleich; der Griff zum Spielstand
## (SaveSystem.reload_last_save) bleibt den Story-Toden vorbehalten:
## Tag-9-Hinterhalt und Dreschen-Prüfung. Optionaler Vorlauf
## (250-Stufen-Turmaufstieg vor dem Steg) ist bewusst NICHT Teil dieses
## CR — bei Bedarf eigener CR.
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 ist der Tod: Respawn am zuletzt erreichten
## Checkpoint, ohne Szenenwechsel und ohne Laden (CR 20, einheitliche
## Todes-Regel). Wurde noch kein Checkpoint berührt, beginnt der Lauf am
## Steganfang. Wind, Wetter und das Balance-QTE werden zurückgesetzt,
## damit der Spieler nicht mitten in einer Böe wieder aufsetzt.
func _on_kill_zone_entered(body: Node3D) -> void:
if not body.is_in_group("player"):
return
_respawn_at_checkpoint()
## Setzt den Spieler am Checkpoint ab und räumt alle Kräfte weg, die den
## Sturz verursacht haben.
func _respawn_at_checkpoint() -> void:
if _player == null:
return
_qte.cancel()
_player.reset_motion()
_player.global_position = _checkpoint_position
## Der aktuelle Respawn-Punkt (für Sonden).
func get_checkpoint_position() -> Vector3:
return _checkpoint_position