windgeschworen/scripts/gameplay/safety_rope_system.gd
danny 6f92fc0ae0 CR-002/CR-003: Gauntlet als vertikaler Kletter-Parcours mit 5 Ascents, ohne Wind
- Gauntlet komplett neu: fuenf Ascent-Sub-Scenes an der Felswand (Fuss
  bis Box-Canyon ~38 m), verbunden ueber schulterbreite Kies-Pfade
  (Training: Checkpoint/Rast, Ernstlauf: Durchgang); Nebel, KillZone,
  Treppen-Visual, 4 Drachen-Silhouetten am Box-Canyon-Eingang
- 10 wiederverwendbare Hindernis-Scenes: spinning_log, granite_pillar,
  spinning_wheel (Ausstiegs-Timing), buoy_ball (momentum_swing: laden +
  im Scheitel loslassen), iron_rail (A/D- bzw. LB/RB-Wechsel-Hangeln),
  shaking_pillar, rolling_log (Tempo-Pflicht, Quetsch-Tod, No-Rope),
  leaning_chimney (X-Spreiz-Modus, kein Seil-Behelf), vertical_ramp
  (Sprint-Momentum), cliff_ledge (bestehendes Kanten-Klettersystem)
- Sicherungsseile alle ~6 Fuss: Sturz oeffnet Greif-Fenster
  (Leertaste/A), Fang = letzter Absatz + 30 s Strafe, sonst Death-State;
  No-Rope-Zone an den Rolling Logs; Ernstlauf sperrt Absteigen
- run_timer (Zeitlauf nur im exam), rival_climbers (5 Kadetten,
  Sturz-Zeitplan + Kanon-Tod an den Rolling Logs), nerve_system
  (Rival-Tode/Ablenkung/Blick nach unten verschlechtern Griff; Steady =
  Strg/L2 senkt Nerven, blockt Klettern), climb_controller (Griff-HUD),
  gauntlet_mode (training/exam + manipulated-Preset)
- CR-003: Wind aus dem Gauntlet entfernt - Drachen-Ablenkung ohne
  Seitenruck und ohne Gegensteuer-QTE (reines Nerven-Ereignis),
  balance_qte auf CR-001-Stand zurueck (Wind nur am Viadukt)
- Story Phase 4c unangetastet auf neuer Geometrie: Auftakt, Intervention
  am Sammel-Absatz vor Ascent 5, Marens Tod, Wahrheiten, Trauer-Wahl;
  erster Besuch = manipulierter Ernstlauf, danach freies Training;
  story_hook_reached(ascent_index) als Anker fuer den Story-CR
- neue Input-Actions steady/swing_charge/grab_rope/hangel_left/
  hangel_right/look_down; Tuning daten-getrieben unter data/gauntlet/
  (gauntlet_tuning.tres + ascent_1..5.tres)
- Verifikation: Headless-Sonde 91/97 gruen (Rest: Buoy-Folgefehler,
  Fix umgesetzt, Bestaetigungslauf auf Wunsch uebersprungen);
  Boot-Check aller 6 Szenen fehlerfrei

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-09 07:28:11 +02:00

198 lines
6.4 KiB
GDScript

extends Node3D
## Sicherungsseile des Gauntlet (CR-002 §6).
##
## Verteilt Seil-Punkte alle rope_spacing (~6 Fuß) entlang der Kurs-Linie
## an der Felswand. Stürzt Tyrveil (Fehlgriff-Signal eines Hindernisses,
## leerer Griff oder freier Fall), prüft das System, ob ein Seil in
## rope_catch_radius hängt und die Stelle keine No-Rope-Zone ist: Dann
## öffnet ein kurzes Greif-Fenster (rope_catch_window, Leertaste/A-Taste).
## Erfolg: Tyrveil hängt am Seil, wird auf den letzten sicheren Absatz
## darunter gesetzt und kassiert rope_time_penalty auf den Zeitlauf.
## Fehlschlag oder kein Seil: freier Fall in die KillZone (Death-State).
## Im Ernstlauf gibt es kein Abklettern an den Seilen — die Descent-Sperre
## liegt im climb_controller.
signal rope_caught(time_penalty: float)
signal catch_failed
@export var rope_spacing := 1.8
@export var rope_catch_radius := 3.5
@export var rope_catch_window := 0.7
@export var rope_time_penalty := 30.0
var _player: CharacterBody3D
var _mode: Node
var _rope_points: Array[Vector3] = []
var _anchors: Array[Vector3] = []
var _no_rope_ranges: Array[Vector2] = []
var _course_z := -4.0
var _is_catching := false
var _label: Label
## Verknüpft Spieler und Modus, erzeugt die Seil-Punkte entlang der
## Kurs-Linie (spine) und merkt sichere Absätze sowie No-Rope-Zonen
## (z-Bereiche).
func setup(player: CharacterBody3D, gauntlet_mode: Node, spine: Array[Vector3], anchors: Array[Vector3], no_rope_ranges: Array[Vector2], course_z: float) -> void:
_player = player
_mode = gauntlet_mode
_anchors = anchors
_no_rope_ranges = no_rope_ranges
_course_z = course_z
_generate_ropes(spine)
_build_ui()
## Anzahl erzeugter Seil-Punkte (für Tests/Overlay).
func rope_count() -> int:
return _rope_points.size()
## Prüft, ob eine z-Position in einer No-Rope-Zone liegt.
func is_in_no_rope(z: float) -> bool:
for zone in _no_rope_ranges:
if z >= zone.x and z <= zone.y:
return true
return false
## Passive Sturz-Erkennung: freier Fall im Parcours startet den
## Seilfang-Versuch.
func _physics_process(_delta: float) -> void:
if _player == null or _is_catching or DialogueSystem.is_dialogue_active:
return
if _player.is_control_locked():
return
if _player.global_position.z > _course_z:
return
if _player.velocity.y < -6.0:
attempt_catch()
## Meldet, ob gerade ein Greif-Fenster läuft (für Tests).
func is_catching() -> bool:
return _is_catching
## Startet den Seilfang-Versuch: Seil in Reichweite und erlaubt -> QTE,
## sonst sofort catch_failed (kein Seilfang möglich -> Death-State).
func attempt_catch() -> void:
if _is_catching:
return
var rope := _nearest_rope(_player.global_position)
if rope == Vector3.INF or is_in_no_rope(_player.global_position.z):
catch_failed.emit()
return
_is_catching = true
_run_catch_qte(rope)
## Spielt das Greif-Fenster als Coroutine: Spieler friert kurz ein,
## Leertaste/A greift das Seil. Der erste Physik-Frame wird übersprungen,
## damit der Tastendruck, der den Sturz auslöste (z. B. vertimter
## Rad-Absprung), nicht sofort als Seilgriff zählt.
func _run_catch_qte(rope: Vector3) -> void:
var frozen := _player.global_position
_player.set_control_locked(true)
_label.text = "SEIL GREIFEN! — Leertaste / A-Taste"
_label.visible = true
await get_tree().physics_frame
var window := rope_catch_window
if _mode != null:
window *= _mode.window_scale()
var start := Time.get_ticks_msec()
var is_caught := false
while float(Time.get_ticks_msec() - start) / 1000.0 < window:
_player.velocity = Vector3.ZERO
_player.global_position = frozen
if Input.is_action_just_pressed("grab_rope"):
is_caught = true
break
await get_tree().physics_frame
_label.visible = false
_player.set_control_locked(false)
_is_catching = false
if is_caught:
_land_at_anchor(rope)
rope_caught.emit(rope_time_penalty)
else:
_player.velocity = Vector3(0, -6, 0)
catch_failed.emit()
## Setzt Tyrveil nach dem Seilfang auf den nächsten sicheren Absatz
## unterhalb des Seils (sie hangelt zurück auf die Route).
func _land_at_anchor(rope: Vector3) -> void:
var best := _anchors[0]
var best_distance := INF
for anchor in _anchors:
if anchor.y > rope.y + 1.0:
continue
var distance := anchor.distance_to(rope)
if distance < best_distance:
best_distance = distance
best = anchor
_player.global_position = best + Vector3(0, 0.2, 0)
_player.velocity = Vector3.ZERO
## Sucht den nächsten Seil-Punkt im Fang-Radius (Vector3.INF = keiner).
func _nearest_rope(from_position: Vector3) -> Vector3:
var best := Vector3.INF
var best_distance := rope_catch_radius
for rope in _rope_points:
var distance := from_position.distance_to(rope)
if distance < best_distance:
best_distance = distance
best = rope
return best
## Erzeugt die Seil-Punkte entlang der Kurs-Linie (alle rope_spacing),
## überspringt No-Rope-Zonen und hängt kleine Visuals an die Wandseite.
func _generate_ropes(spine: Array[Vector3]) -> void:
for i in spine.size() - 1:
var from := spine[i]
var to := spine[i + 1]
var length := from.distance_to(to)
var steps := int(length / rope_spacing)
for step in steps:
var point := from.lerp(to, float(step) / float(maxi(steps, 1)))
if is_in_no_rope(point.z):
continue
point.x += 1.5
_rope_points.append(point)
add_child(_make_rope_visual(point))
## Baut das kleine Seil-Visual (heller Strang an der Wand).
func _make_rope_visual(point: Vector3) -> MeshInstance3D:
var mesh_instance := MeshInstance3D.new()
var mesh := BoxMesh.new()
mesh.size = Vector3(0.08, 1.2, 0.08)
var material := StandardMaterial3D.new()
material.albedo_color = Color(0.85, 0.8, 0.6)
mesh.material = material
mesh_instance.mesh = mesh
mesh_instance.position = point
return mesh_instance
## Baut den Greif-Prompt (zentriert, versteckt).
func _build_ui() -> void:
var layer := CanvasLayer.new()
layer.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(0.95, 0.9, 0.5))
_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)
layer.add_child(root)
add_child(layer)