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

112 lines
3.9 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)
@export var grab_radius := 2.8
var _ball: MeshInstance3D
var _time := 0.0
var _is_holding := false
var _charge := 0.0
var _was_charging := false
var _regrab_cooldown := 0.0
## 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)))
add_world_prompt(Vector3(0, 1.1, 0), "swing_charge", "Schwung")
## 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
_regrab_cooldown = maxf(_regrab_cooldown - delta, 0.0)
var phase := _time * TAU / buoy_swing_period
_ball.position = Vector3(0, 0, sin(phase) * swing_amplitude)
var player := get_player()
if player == null:
return
if not _is_holding:
_try_grab(player)
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 %s loslassen" % [int(_charge * 100.0), InputPrompts.prompt("swing_charge")])
elif _was_charging:
_release(player)
else:
show_prompt("%s HALTEN — Schwung laden" % InputPrompts.prompt("swing_charge"))
_was_charging = is_charging
## Greift per Abstands-Polling statt Zonen-Events (CR Kollision/Greifen):
## Sobald der freie Spieler nah genug an der Kugel und nicht über ihr
## ist, klammert er sich fest — egal ob er hineinspringt, hineinfällt
## oder schon im Bereich stand. Die Wiedergreif-Sperre verhindert, dass
## dieselbe Kugel den gerade gelösten Spieler sofort wieder einsammelt.
func _try_grab(player: CharacterBody3D) -> void:
if _regrab_cooldown > 0.0 or not is_player_free(player):
return
var local := to_local(player.global_position)
if local.y > _ball.position.y + 0.6:
return
if local.distance_to(_ball.position) > grab_radius:
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
_regrab_cooldown = 1.5
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