windgeschworen/scripts/gameplay/safety_rope_field.gd
danny 1a2c1be65d CR-Paket: Rad flach + tastenlos, Kugel-Griff gefixt, Seil-Prioritaet, dynamische Button-Prompts
- spinning_wheel: flache Dreh-Scheibe im Laufweg statt aufrechter
  Trommel; Interaktion rein ueber Hitbox (drauflaufen, kein Tastendruck):
  Drehung reisst tangential mit (A/D gegenhalten), fehlendes Tortenstueck
  laesst am Boden durchfallen (im Sprung uebersprungen), Nabe sicher,
  Ausstiegs-Zone meldet den Uebergang
- buoy_ball: Greifen von body_entered-Events auf Abstands-Polling
  umgestellt (Events feuerten nicht, wenn der Spieler schon im Bereich
  stand -> Kugeln waren nicht greifbar); grab_radius-Export,
  Wiedergreif-Sperre 1,5 s nach jedem Loslassen gegen sofortiges
  Wieder-Einsammeln durch dieselbe Kugel
- safety_rope_field: Fang nur bei echtem Sturz (Fall unter -7 m/s UND
  Sturzkorridor oder >3 m unter letzter Standhoehe) - kurze Huepfer
  loesen kein Greif-Fenster mehr aus; keine Eingabe-Kollision Rad/Seil
- InputPrompts-Autoload implementiert (war Skelett): erkennt Tastatur
  vs. Xbox/PlayStation am letzten Input-Event bzw. Joypad-Namen,
  liefert Action-Labels ([E]/[Leertaste] vs. [A]/[LB] vs. [Kreuz]/[L1]),
  device_changed fuer Live-Umschaltung; Welt-Prompts (Label3D) an
  Kugeln/Schienen/Kamin, Bildschirm-Prompts nutzen dynamische Labels
- gravel_curve.gd nachcommittet (fehlte in V.0.6.1, wird von der
  Gauntlet-Szene referenziert)
- Verifikation: Headless-Sonde komplett gruen (70+ Checks inkl. neuer
  Rad-/Kugel-/Seil-/Prompt-Tests), Boot-Check aller 6 Szenen fehlerfrei
- v1-Ausbau (10-Tage-Zyklus) bleibt als Phasen-Programm in
  CHANGEREQUESTS.md, Fix-CRs nach CHANGEREQUESTS_DONE.md uebertragen

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

230 lines
7.6 KiB
GDScript

extends Node3D
## Seilfeld im Sturzkorridor (CR-003 §4) — ersetzt die Wand-Anker aus
## CR-002.
##
## Die Seile hängen frei AUSSEN im Sturzkorridor vor der offenen
## Terrassen-Seite, über die volle Wandhöhe, im Abstand rope_spacing.
## Der Seilfang ist ein Fall-Feature: Stürzt Tyrveil nach außen, fällt
## sie ins Seilfeld und bekommt ein Greif-Fenster (rope_catch_window,
## Leertaste/A). Erfolg: Sie hängt frei am Seil, arbeitet sich in
## rope_recover_time zurück auf den letzten sicheren Absatz und kassiert
## rope_time_penalty. Fehlschlag: Sie fällt durch das Feld -> rope_missed
## (Death-State). JEDE Seilberührung zählt: Auch wer im Lauf ein Seil
## streift, kassiert die Strafe (rope_touched). Stürze, die auf der
## No-Rope-Terrasse beginnen (Rolling Logs), gehen den Hang hinab und
## erreichen das Feld nie -> kein Fang, sicher tödlich. Im Ernstlauf gibt
## es kein Abklettern am Seil (Descent-Sperre im climb_controller).
signal rope_touched(time_penalty: float)
signal rope_caught
signal rope_missed
@export var rope_spacing := 1.8
@export var rope_catch_window := 0.7
@export var rope_recover_time := 1.2
@export var rope_time_penalty := 30.0
@export var corridor_z := 2.4
@export var corridor_top := 32.0
@export var touch_radius := 0.5
@export var course_min_x := -20.0
var _player: CharacterBody3D
var _mode: Node
var _rope_xs: PackedFloat32Array = PackedFloat32Array()
var _anchors: Array[Vector3] = []
var _no_rope_bands: Array[Vector2] = []
var _last_floor_y := 0.0
var _is_catching := false
var _touch_cooldown := 0.0
var _label: Label
## Verknüpft Spieler und Modus, hängt die Seile über den x-Bereich des
## Kurses und merkt sichere Absätze sowie No-Rope-Bänder (Absturz-
## Ursprungshöhen der Rolling-Logs-Terrasse).
func setup(player: CharacterBody3D, gauntlet_mode: Node, x_min: float, x_max: float, anchors: Array[Vector3], no_rope_bands: Array[Vector2]) -> void:
_player = player
_mode = gauntlet_mode
_anchors = anchors
_no_rope_bands = no_rope_bands
var x := x_min
while x <= x_max:
_rope_xs.append(x)
add_child(_make_rope_visual(x))
x += rope_spacing
_build_ui()
## Anzahl gespannter Seile (für Tests/Overlay).
func rope_count() -> int:
return _rope_xs.size()
## Meldet, ob gerade ein Greif-Fenster oder die Hang-Phase läuft.
func is_catching() -> bool:
return _is_catching
## Prüft, ob eine Absturz-Ursprungshöhe in einem No-Rope-Band liegt.
func is_in_no_rope(origin_y: float) -> bool:
for band in _no_rope_bands:
if origin_y >= band.x and origin_y <= band.y:
return true
return false
## Verfolgt die letzte sichere Standhöhe, erkennt freie Stürze und
## Seil-Berührungen im Vorbeigehen.
func _physics_process(delta: float) -> void:
if _player == null or DialogueSystem.is_dialogue_active:
return
_touch_cooldown = maxf(_touch_cooldown - delta, 0.0)
if _is_catching or _player.is_control_locked():
return
if _player.is_on_floor():
_last_floor_y = _player.global_position.y
if not _is_in_course():
return
_check_passing_touch()
if _player.velocity.y > -7.0:
return
var is_in_corridor: bool = _player.global_position.z > 0.8
var is_deep_fall: bool = _player.global_position.y < _last_floor_y - 3.0
if is_in_corridor or is_deep_fall:
attempt_catch()
## Startet den Seilfang-Versuch: In No-Rope-Zonen gibt es keinen Fang
## (rope_missed), sonst öffnet das Greif-Fenster im Fall.
func attempt_catch() -> void:
if _is_catching:
return
if is_in_no_rope(_last_floor_y):
rope_missed.emit()
return
_is_catching = true
_run_catch_qte()
## Spielt Greif-Fenster und Hang-Phase als Coroutine: Der Fall friert
## kurz ein, Leertaste/A greift; danach hängt Tyrveil rope_recover_time
## am Seil und wird auf den letzten sicheren Absatz gesetzt. Der erste
## Physik-Frame wird übersprungen, damit der Tastendruck, der den Sturz
## auslöste, nicht sofort als Griff zählt.
func _run_catch_qte() -> void:
var frozen := _player.global_position
_player.set_control_locked(true)
_label.text = "SEIL GREIFEN! — %s" % InputPrompts.prompt("grab_rope")
_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
if not is_caught:
_label.visible = false
_player.set_control_locked(false)
_is_catching = false
_player.velocity = Vector3(0, -6, 0)
rope_missed.emit()
return
rope_caught.emit()
rope_touched.emit(rope_time_penalty)
var rope_x := _nearest_rope_x(frozen.x)
var hang := Vector3(rope_x, maxf(frozen.y, 2.0), corridor_z - 0.5)
_label.text = "Am Seil — zurückarbeiten …"
var hang_start := Time.get_ticks_msec()
while float(Time.get_ticks_msec() - hang_start) / 1000.0 < rope_recover_time:
_player.velocity = Vector3.ZERO
_player.global_position = hang
await get_tree().physics_frame
_label.visible = false
_player.set_control_locked(false)
_is_catching = false
_land_at_anchor(hang)
## Setzt Tyrveil nach der Hang-Phase auf den nächsten sicheren Absatz
## unterhalb der Fangstelle.
func _land_at_anchor(hang: Vector3) -> void:
var best := _anchors[0]
var best_distance := INF
for anchor in _anchors:
if anchor.y > hang.y + 1.5:
continue
var distance := anchor.distance_to(hang)
if distance < best_distance:
best_distance = distance
best = anchor
_player.global_position = best + Vector3(0, 0.2, 0)
_player.velocity = Vector3.ZERO
## Berührung im Vorbeigehen: Wer einem hängenden Seil zu nahe kommt,
## kassiert die Zeitstrafe (mit Abkling-Sperre gegen Mehrfach-Zählung).
func _check_passing_touch() -> void:
if _touch_cooldown > 0.0:
return
var position := _player.global_position
if absf(position.z - corridor_z) > touch_radius:
return
var rope_x := _nearest_rope_x(position.x)
if absf(position.x - rope_x) > touch_radius:
return
_touch_cooldown = 3.0
rope_touched.emit(rope_time_penalty)
## Liefert die x-Position des nächstgelegenen Seils.
func _nearest_rope_x(x: float) -> float:
var best := _rope_xs[0]
for rope_x in _rope_xs:
if absf(rope_x - x) < absf(best - x):
best = rope_x
return best
## Prüft, ob Tyrveil den Parcours betreten hat (jenseits des Fußes).
func _is_in_course() -> bool:
return _player.global_position.x > course_min_x or _player.global_position.y > 2.0
## Baut das hängende Seil-Visual über die volle Wandhöhe.
func _make_rope_visual(x: float) -> MeshInstance3D:
var mesh_instance := MeshInstance3D.new()
var mesh := BoxMesh.new()
mesh.size = Vector3(0.07, corridor_top + 8.0, 0.07)
var material := StandardMaterial3D.new()
material.albedo_color = Color(0.85, 0.8, 0.6)
mesh.material = material
mesh_instance.mesh = mesh
mesh_instance.position = Vector3(x, corridor_top / 2.0 - 4.0, corridor_z)
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)