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