108 lines
3.7 KiB
GDScript
108 lines
3.7 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; der Abstands-Check fängt veraltete Zonen-Events der pendelnden
|
|
## Kugel ab (z. B. nach einem Respawn quer über die Terrasse).
|
|
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
|
|
if to_local(player.global_position).distance_to(_ball.position) > 3.0:
|
|
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
|