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

138 lines
4.9 KiB
GDScript

extends GauntletObstacle
## Spinning Wheel als flache Dreh-Scheibe (CR Gameplay-Fixes: das Rad
## liegt flach auf dem Boden, Interaktion rein über Hitbox — kein
## Tastendruck zum Starten).
##
## Die Scheibe liegt flach im Laufweg und dreht sich konstant um die
## Hochachse. Wer sie betritt (einfach hineinlaufen), wird von der
## Drehung tangential mitgerissen (wheel_carry_force, mit A/D bzw. Stick
## gegenhalten und weiterlaufen). Ein Tortenstück der Scheibe fehlt
## (wheel_gap_arc): Wandert die Lücke unter die Füße, fällt der Läufer
## durch — es sei denn, er ist gerade im Sprung darüber. Die Nabe in der
## Mitte ist durchgehend sicher. Am gegenüberliegenden Rand meldet eine
## Ausstiegs-Zone den geschafften Übergang. Zwei Dummy-Kadetten drehen
## als Timing-Referenz sichtbar mit.
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_carry_force := 1.0
@export var hub_radius := 0.7
var _pivot: Node3D
var _was_on_disc := false
var _has_entered := false
var _has_exited := false
var _was_gap_near := false
var _time := 0.0
## Baut Scheiben-Segmente (mit Lücke), Nabe, Kollisions-Scheibe,
## Dummy-Kadetten und die Ausstiegs-Zone.
func _ready() -> void:
super()
var radius := wheel_diameter / 2.0
var body := StaticBody3D.new()
var shape := CollisionShape3D.new()
var cylinder := CylinderShape3D.new()
cylinder.radius = radius
cylinder.height = 0.5
shape.shape = cylinder
shape.position = Vector3(0, -0.25, 0)
body.add_child(shape)
add_child(body)
_pivot = Node3D.new()
add_child(_pivot)
var gap_half := wheel_gap_arc / 2.0
var segment_count := 12
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.75, 0.15, radius - hub_radius + 0.1), Vector3(sin(angle) * (radius + hub_radius) / 2.0, 0.08, cos(angle) * (radius + hub_radius) / 2.0), Color(0.5, 0.4, 0.3))
segment.rotation.y = angle
_pivot.add_child(segment)
var hub := build_cylinder_mesh(hub_radius, 0.2, Vector3(0, 0.1, 0), Color(0.35, 0.3, 0.25))
_pivot.add_child(hub)
var dummy1 := build_box_mesh(Vector3(0.45, 1.3, 0.45), Vector3(sin(1.2) * 1.4, 0.75, cos(1.2) * 1.4), Color(0.35, 0.35, 0.5))
_pivot.add_child(dummy1)
var dummy2 := build_box_mesh(Vector3(0.45, 1.3, 0.45), Vector3(sin(3.6) * 1.4, 0.75, cos(3.6) * 1.4), Color(0.3, 0.4, 0.45))
_pivot.add_child(dummy2)
var exit_zone := build_area(self, Vector3(1.2, 2.2, 2.4), Vector3(radius + 0.7, 1.0, 0))
exit_zone.body_entered.connect(_on_exit_zone)
## Dreht die Scheibe und wendet Mitreiß-Kraft, Lücken-Logik und
## Betreten-Erkennung auf den Läufer an.
func _physics_process(delta: float) -> void:
_time += delta
_pivot.rotate_y(wheel_speed * float(wheel_dir) * delta)
var player := get_player()
if player == null:
return
var local := to_local(player.global_position)
var radial := Vector2(local.x, local.z)
var radius := wheel_diameter / 2.0
var is_on_disc := radial.length() < radius - 0.1 and local.y > -0.3 and local.y < 1.6
if not is_on_disc:
if _was_on_disc:
player.external_push = Vector3.ZERO
_was_on_disc = false
return
if not is_player_free(player):
return
if not _has_entered:
_has_entered = true
wheel_entered.emit()
_was_on_disc = true
var spin := wheel_speed * float(wheel_dir) * wheel_carry_force
var push := Vector3(local.z * spin, 0.0, -local.x * spin)
if nerve != null:
push *= nerve.drift_factor()
player.external_push = global_transform.basis * push
_process_gap(player, local, radial)
## Prüft, ob die Lücke unter dem Läufer durchzieht: Am Boden fällt er
## durch, im Sprung darüber gilt sie als übersprungen. Die Nabe ist safe.
func _process_gap(player: CharacterBody3D, local: Vector3, radial: Vector2) -> void:
if radial.length() < hub_radius + 0.2:
_was_gap_near = false
return
var player_angle := atan2(local.x, local.z)
var gap_center := wrapf(_pivot.rotation.y, -PI, PI)
var distance := absf(wrapf(player_angle - gap_center, -PI, PI))
var is_gap_under := distance < wheel_gap_arc / 2.0 * 0.8
if is_gap_under:
if player.is_on_floor():
player.external_push = Vector3.ZERO
player.global_position = to_global(Vector3(local.x, -0.8, local.z))
player.velocity = Vector3(0, -6.5, 0)
_was_on_disc = false
_was_gap_near = false
report_fall()
return
if not _was_gap_near:
_was_gap_near = true
wheel_gap_cleared.emit()
else:
_was_gap_near = false
## Ausstiegs-Zone hinter der Scheibe erreicht: Übergang geschafft.
func _on_exit_zone(body: Node3D) -> void:
if not body.is_in_group("player"):
return
if not _has_exited:
_has_exited = true
wheel_exited.emit()
mark_cleared()
## Meldet, ob der Läufer gerade auf der Scheibe steht (für Tests).
func is_riding() -> bool:
return _was_on_disc