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

104 lines
3.5 KiB
GDScript

extends GauntletObstacle
## Buoy Ball (CR-002, ascent_2): hängende Kugel zum Umklammern und
## Anschwingen (momentum_swing, CR §8b).
##
## Die Kugel pendelt entlang der Laufrichtung. Springt der Spieler in die
## Greif-Zone, klammert er sich fest und pendelt mit. Schwung-Taste
## (Leertaste/A) halten lädt über momentum_charge_time den Schwung;
## Loslassen im Scheitel-Fenster (launch_window) katapultiert zur
## launch_target-Position (nächste Kugel oder Absatz). Zu früh/zu spät/
## ungeladen gelöst -> zu kurz -> Sturz (player_fell).
@export var buoy_swing_period := 2.4
@export var swing_amplitude := 1.2
@export var launch_window := 0.5
@export var momentum_charge_time := 0.9
@export var launch_target := Vector3(0, 1.2, -2.6)
var _ball: MeshInstance3D
var _grab_area: Area3D
var _time := 0.0
var _is_holding := false
var _charge := 0.0
var _was_charging := false
## Baut Kugel, Seil-Visual und Greif-Zone.
func _ready() -> void:
super()
_ball = MeshInstance3D.new()
var sphere := SphereMesh.new()
sphere.radius = 0.5
sphere.height = 1.0
sphere.material = _make_material(Color(0.75, 0.3, 0.25))
_ball.mesh = sphere
add_child(_ball)
add_child(build_box_mesh(Vector3(0.06, 2.4, 0.06), Vector3(0, 1.5, 0), Color(0.3, 0.28, 0.25)))
_grab_area = build_area(self, Vector3(2.2, 2.8, 2.2 + swing_amplitude * 2.0), Vector3(0, -0.9, 0))
_grab_area.body_entered.connect(_on_grab)
## Pendelt die Kugel; hält der Spieler sich fest, folgt er ihr, lädt
## Schwung und wird beim Loslassen ausgewertet.
func _physics_process(delta: float) -> void:
_time += delta
var phase := _time * TAU / buoy_swing_period
_ball.position = Vector3(0, 0, sin(phase) * swing_amplitude)
_grab_area.position = _ball.position + Vector3(0, -0.9, 0)
if not _is_holding:
return
var player := get_player()
if player == null:
return
player.velocity = Vector3.ZERO
player.global_position = to_global(_ball.position + Vector3(0, -1.5, 0))
var is_charging := Input.is_action_pressed("swing_charge")
if is_charging:
_charge = minf(_charge + delta / momentum_charge_time, 1.0)
show_prompt("Schwung laden: %d%% — im Scheitel loslassen (Leertaste / A-Taste)" % int(_charge * 100.0))
elif _was_charging:
_release(player)
else:
show_prompt("Leertaste / A-Taste HALTEN — Schwung laden")
_was_charging = is_charging
## Klammert den Spieler an die Kugel, wenn er frei in die Greif-Zone kommt.
func _on_grab(body: Node3D) -> void:
if _is_holding or not body.is_in_group("player"):
return
var player := body as CharacterBody3D
if not is_player_free(player):
return
_is_holding = true
_charge = 0.0
_was_charging = false
player.set_control_locked(true)
## Wertet das Loslassen aus: voll geladen im Scheitel-Fenster -> Launch zum
## Ziel, sonst zu kurz -> Sturz.
func _release(player: CharacterBody3D) -> void:
_is_holding = false
hide_prompt()
player.set_control_locked(false)
if _charge >= 1.0 and _is_in_launch_window():
player.global_position = to_global(launch_target)
player.velocity = Vector3.ZERO
mark_cleared()
else:
player.velocity = Vector3(0, -8.0, 0)
report_fall()
## Prüft, ob das Pendel gerade im Scheitel-Fenster steht (Geschwindigkeit
## nahe null an den Umkehrpunkten).
func _is_in_launch_window() -> bool:
var phase := fposmod(_time * TAU / buoy_swing_period, PI)
var window_half := TAU * launch_window / buoy_swing_period / 2.0
return absf(phase - PI / 2.0) < maxf(window_half, 0.15)
## Meldet, ob der Spieler gerade an der Kugel hängt (für Tests).
func is_holding() -> bool:
return _is_holding