windgeschworen/scripts/gameplay/obstacles/spinning_wheel.gd
2026-07-11 14:53:26 +02:00

205 lines
7.5 KiB
GDScript

extends GauntletObstacle
## Spinning Wheel als geschlossene Trommel (CR-003 §3b).
##
## Die Trommel steht mit der Radebene parallel zur Felswand (Achse zeigt
## in die Wand); die äußere Haut ist durchgehend bis auf genau eine Lücke
## (wheel_gap_arc). Ablauf: (1) seitlich durch die Lücke einspringen,
## wenn sie an der Einstiegsseite vorbeikommt (wheel_entry_window),
## (2) innen auf der Trommel-Innenfläche mitlaufen — die Drehung trägt
## den Läufer sonst die Wand hoch (wheel_carry_force, A/D hält dagegen),
## (3) wandert die Lücke unter den Füßen durch, rechtzeitig darüber
## springen (gap_jump_window), sonst fällt er durch die Trommel,
## (4) an der gegenüberliegenden Seite im Fenster wheel_exit_window durch
## die Lücke hinausspringen. Zwei Dummy-Kadetten laufen sichtbar mit
## (Timing-Referenz). Ein vertimter Einsprung prallt an der Haut ab
## (Rückstoß, kein Tod); Fehler INNEN sind Stürze (player_fell).
signal wheel_entered
signal wheel_gap_cleared
signal wheel_exited
@export var wheel_diameter := 4.0
@export var wheel_speed := 0.8
@export var wheel_dir := 1
@export var wheel_gap_arc := 1.0
@export var wheel_entry_window := 0.6
@export var gap_jump_window := 0.6
@export var wheel_exit_window := 0.5
@export var wheel_carry_force := 0.35
@export var carry_limit := 0.9
var _pivot: Node3D
var _dummy1: MeshInstance3D
var _dummy2: MeshInstance3D
var _is_riding := false
var _is_in_entry_zone := false
var _player_angle := 0.0
var _hop_timer := 0.0
var _has_cleared_pass := false
var _time := 0.0
## Baut Haut-Segmente (mit Lücke), Nabe, Dummy-Kadetten, Einstiegs-Zone
## und Ausstiegs-Plattform.
func _ready() -> void:
super()
var radius := wheel_diameter / 2.0
_pivot = Node3D.new()
add_child(_pivot)
var gap_half := wheel_gap_arc / 2.0
var segment_count := 14
var arc := TAU - wheel_gap_arc
for i in segment_count:
var angle := gap_half + arc * (float(i) + 0.5) / float(segment_count)
var segment := build_box_mesh(Vector3(arc / float(segment_count) * radius + 0.12, 0.3, 1.7), Vector3(sin(angle) * radius, -cos(angle) * radius, 0), Color(0.5, 0.4, 0.3))
segment.rotation.z = angle
_pivot.add_child(segment)
add_child(build_box_mesh(Vector3(0.5, 0.5, 2.0), Vector3.ZERO, Color(0.35, 0.3, 0.25)))
_dummy1 = build_box_mesh(Vector3(0.45, 1.3, 0.45), Vector3.ZERO, Color(0.35, 0.35, 0.5))
add_child(_dummy1)
_dummy2 = build_box_mesh(Vector3(0.45, 1.3, 0.45), Vector3.ZERO, Color(0.3, 0.4, 0.45))
add_child(_dummy2)
var entry := build_area(self, Vector3(1.8, 2.0, 2.0), Vector3(-radius - 1.0, -radius + 1.0, 0))
entry.body_entered.connect(_on_entry_zone_entered)
entry.body_exited.connect(_on_entry_zone_exited)
build_box(self, Vector3(1.8, 0.5, 1.8), Vector3(radius + 1.4, -radius + 0.25, 0), Color(0.55, 0.54, 0.52))
## Merkt, dass der Spieler in der Einstiegs-Zone steht.
func _on_entry_zone_entered(body: Node3D) -> void:
if body.is_in_group("player"):
_is_in_entry_zone = true
## Merkt, dass der Spieler die Einstiegs-Zone verlassen hat.
func _on_entry_zone_exited(body: Node3D) -> void:
if body.is_in_group("player"):
_is_in_entry_zone = false
if not _is_riding:
hide_prompt()
## Dreht die Trommel, positioniert Dummy-Kadetten und treibt Einstieg,
## Mitlaufen, Lücken-Sprung und Ausstieg an.
func _physics_process(delta: float) -> void:
_time += delta
_pivot.rotate_z(wheel_speed * float(wheel_dir) * delta)
var radius := wheel_diameter / 2.0
var inner := radius - 0.55
_dummy1.position = Vector3(sin(0.55 + sin(_time * 2.0) * 0.08) * inner, -cos(0.55) * inner + 0.65, 0.4)
_dummy2.position = Vector3(sin(-0.5 + sin(_time * 1.7) * 0.08) * inner, -cos(-0.5) * inner + 0.65, -0.4)
var player := get_player()
if player == null:
return
if _is_riding:
_process_ride(player, delta, inner)
else:
_process_entry(player)
## Einstieg: In der Zone warten, bis die Lücke links vorbeikommt, dann
## Leertaste; vertimter Sprung prallt an der Haut ab.
func _process_entry(player: CharacterBody3D) -> void:
if not _is_in_entry_zone or not is_player_free(player):
return
var is_gap_at_entry := _angle_distance(_gap_angle(), -PI / 2.0) < _window_tolerance(wheel_entry_window)
if is_gap_at_entry:
show_prompt("JETZT: durch die Lücke! — Leertaste / A-Taste")
else:
show_prompt("Warten, bis die Lücke links ist — Leertaste / A-Taste")
if not Input.is_action_just_pressed("jump"):
return
hide_prompt()
if is_gap_at_entry:
_is_riding = true
_player_angle = 0.0
_hop_timer = 0.0
_has_cleared_pass = false
player.set_control_locked(true)
wheel_entered.emit()
else:
player.velocity = global_transform.basis.x * -3.0 + Vector3(0, 2.0, 0)
## Fahrt in der Trommel: Mitlaufen gegen die Drehung, Lücke überspringen,
## Ausstieg an der Gegenseite timen.
func _process_ride(player: CharacterBody3D, delta: float, inner: float) -> void:
_hop_timer = maxf(_hop_timer - delta, 0.0)
_player_angle += wheel_speed * float(wheel_dir) * wheel_carry_force * delta
_player_angle += Input.get_axis("move_left", "move_right") * 1.1 * delta
player.velocity = Vector3.ZERO
player.global_position = to_global(Vector3(sin(_player_angle) * inner, -cos(_player_angle) * inner, 0))
if absf(_player_angle) > carry_limit:
_fail_ride(player, Vector3(0, 2.0, 0))
return
var gap := _gap_angle()
var gap_half := wheel_gap_arc / 2.0
var is_gap_under := _angle_distance(gap, _player_angle) < gap_half * 0.7
var is_exit_window := _angle_distance(gap, PI / 2.0) < _window_tolerance(wheel_exit_window)
if is_gap_under:
if _hop_timer > 0.0 or _has_cleared_pass:
if not _has_cleared_pass:
_has_cleared_pass = true
wheel_gap_cleared.emit()
else:
player.global_position = to_global(Vector3(sin(_player_angle) * (inner + 0.8), -cos(_player_angle) * (inner + 0.8), 0))
_fail_ride(player, Vector3(0, -6.5, 0))
return
else:
_has_cleared_pass = false
if is_exit_window:
show_prompt("AUSSTIEG rechts: durch die Lücke! — Leertaste / A-Taste")
elif _angle_distance(gap, _player_angle) < gap_half + 0.6:
show_prompt("Die Lücke kommt: DRÜBERSPRINGEN — Leertaste / A-Taste")
else:
show_prompt("Mitlaufen: A/D bzw. Stick gegen die Drehung")
if Input.is_action_just_pressed("jump"):
if is_exit_window:
_finish_ride(player)
else:
_hop_timer = gap_jump_window
## Erfolgreicher Ausstieg durch die Lücke auf die Plattform dahinter.
func _finish_ride(player: CharacterBody3D) -> void:
_is_riding = false
hide_prompt()
player.set_control_locked(false)
var radius := wheel_diameter / 2.0
player.global_position = to_global(Vector3(radius + 1.4, -radius + 1.0, 0))
player.velocity = Vector3.ZERO
wheel_exited.emit()
mark_cleared()
## Sturz in der Trommel (mitgerissen oder durch die Lücke gefallen).
func _fail_ride(player: CharacterBody3D, exit_velocity: Vector3) -> void:
_is_riding = false
hide_prompt()
player.set_control_locked(false)
player.velocity = exit_velocity
report_fall()
## Aktuelle Welt-Winkelposition der Lücke (0 = unten, +pi/2 = rechts).
func _gap_angle() -> float:
return wrapf(_pivot.rotation.z, -PI, PI)
## Toleranz eines Zeitfensters als Winkel (skaliert mit der Drehung und
## dem manipulated-Fenster des Modus).
func _window_tolerance(window: float) -> float:
var scaled := window
if mode != null:
scaled *= mode.window_scale()
return maxf(wheel_gap_arc * 0.4 + wheel_speed * scaled * 0.5, 0.2)
## Kleinste Winkeldistanz zweier Winkel.
func _angle_distance(a: float, b: float) -> float:
return absf(wrapf(a - b, -PI, PI))
## Meldet, ob der Spieler gerade in der Trommel mitfährt (für Tests).
func is_riding() -> bool:
return _is_riding