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