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

171 lines
5.5 KiB
GDScript

class_name GauntletObstacle
extends Node3D
## Basisklasse aller Gauntlet-Hindernisse (CR-002).
##
## Liefert die gemeinsame Infrastruktur: Signale cleared/player_fell,
## Greybox-Baukasten für Boxen, Zylinder und Trigger-Areas, Zugriff auf
## den Spieler sowie einen Bildschirm-Prompt (Tastatur- UND
## Controller-Glyphe als Text, solange InputPrompts noch Skelett ist).
## Hindernisse registrieren sich in der Gruppe gauntlet_obstacle; die
## Szenen-Steuerung injiziert über setup_context Nerven-System und Modus.
signal cleared(obstacle_id: String)
signal player_fell(source_id: String)
@export var obstacle_id := ""
var nerve: Node
var mode: Node
var _is_cleared := false
var _prompt_layer: CanvasLayer
var _prompt_label: Label
## Registriert das Hindernis für die Kontext-Injektion der Szene.
func _ready() -> void:
add_to_group("gauntlet_obstacle")
## Bekommt Nerven-System und Gauntlet-Modus von der Szene gereicht.
func setup_context(nerve_system: Node, gauntlet_mode: Node) -> void:
nerve = nerve_system
mode = gauntlet_mode
## Meldet das Hindernis einmalig als geschafft.
func mark_cleared() -> void:
if _is_cleared:
return
_is_cleared = true
cleared.emit(obstacle_id)
## Meldet einen Sturz des Spielers an diesem Hindernis.
func report_fall() -> void:
player_fell.emit(obstacle_id)
## Liefert den Spieler oder null.
func get_player() -> CharacterBody3D:
return get_tree().get_first_node_in_group("player") as CharacterBody3D
## Prüft, ob der Spieler gerade frei steuerbar ist (kein Dialog, kein
## anderes Set-Piece hält ihn fest).
func is_player_free(player: CharacterBody3D) -> bool:
return player != null and not DialogueSystem.is_dialogue_active and not player.is_control_locked()
## Baut eine begehbare Greybox-Box (Kollision + Mesh) als Kind von parent.
func build_box(parent: Node3D, box_size: Vector3, local_position: Vector3, color: Color) -> StaticBody3D:
var body := StaticBody3D.new()
body.position = local_position
var shape := CollisionShape3D.new()
var box := BoxShape3D.new()
box.size = box_size
shape.shape = box
body.add_child(shape)
body.add_child(build_box_mesh(box_size, Vector3.ZERO, color))
parent.add_child(body)
return body
## Baut ein reines Box-Mesh ohne Kollision (Deko/Silhouetten).
func build_box_mesh(box_size: Vector3, local_position: Vector3, color: Color) -> MeshInstance3D:
var mesh_instance := MeshInstance3D.new()
var mesh := BoxMesh.new()
mesh.size = box_size
mesh.material = _make_material(color)
mesh_instance.mesh = mesh
mesh_instance.position = local_position
return mesh_instance
## Baut ein Zylinder-Mesh ohne Kollision (rotierende Stämme, Räder).
func build_cylinder_mesh(radius: float, height: float, local_position: Vector3, color: Color) -> MeshInstance3D:
var mesh_instance := MeshInstance3D.new()
var mesh := CylinderMesh.new()
mesh.top_radius = radius
mesh.bottom_radius = radius
mesh.height = height
mesh.material = _make_material(color)
mesh_instance.mesh = mesh
mesh_instance.position = local_position
return mesh_instance
## Baut eine Trigger-Area mit Box-Shape, die nur den Spieler (Layer 2)
## erkennt.
func build_area(parent: Node3D, box_size: Vector3, local_position: Vector3) -> Area3D:
var area := Area3D.new()
area.collision_layer = 0
area.collision_mask = 2
area.position = local_position
var shape := CollisionShape3D.new()
var box := BoxShape3D.new()
box.size = box_size
shape.shape = box
area.add_child(shape)
parent.add_child(area)
return area
## Hängt einen Welt-Prompt (Label3D-Billboard) an das Hindernis, der die
## Taste der Action für das aktive Eingabegerät zeigt (z. B. "[E] Öffnen"
## bzw. "[✕] Öffnen") und bei Gerätewechsel live umschaltet.
func add_world_prompt(local_position: Vector3, action: String, suffix: String) -> Label3D:
var label := Label3D.new()
label.billboard = BaseMaterial3D.BILLBOARD_ENABLED
label.font_size = 44
label.outline_size = 12
label.modulate = Color(1, 0.9, 0.5)
label.position = local_position
add_child(label)
var update := func() -> void:
label.text = "%s %s" % [InputPrompts.prompt(action), suffix]
update.call()
InputPrompts.device_changed.connect(func(_device: int) -> void: update.call())
return label
## Zeigt einen zentrierten Bildschirm-Prompt (baut die UI beim ersten
## Aufruf lazy auf).
func show_prompt(text: String) -> void:
if _prompt_label == null:
_build_prompt_ui()
_prompt_label.text = text
_prompt_label.visible = true
## Blendet den Bildschirm-Prompt aus.
func hide_prompt() -> void:
if _prompt_label != null:
_prompt_label.visible = false
## Baut die Prompt-UI (CanvasLayer + Label, unteres Drittel).
func _build_prompt_ui() -> void:
_prompt_layer = CanvasLayer.new()
_prompt_layer.layer = 3
var root := Control.new()
root.set_anchors_preset(Control.PRESET_FULL_RECT)
root.mouse_filter = Control.MOUSE_FILTER_IGNORE
_prompt_label = Label.new()
_prompt_label.set_anchors_preset(Control.PRESET_CENTER_BOTTOM)
_prompt_label.position.y -= 140.0
_prompt_label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
_prompt_label.add_theme_font_size_override("font_size", 30)
_prompt_label.add_theme_color_override("font_color", Color(1, 0.85, 0.4))
_prompt_label.add_theme_color_override("font_outline_color", Color.BLACK)
_prompt_label.add_theme_constant_override("outline_size", 8)
_prompt_label.visible = false
root.add_child(_prompt_label)
_prompt_layer.add_child(root)
add_child(_prompt_layer)
## Erstellt ein einfarbiges Greybox-Material.
func _make_material(color: Color) -> StandardMaterial3D:
var material := StandardMaterial3D.new()
material.albedo_color = color
return material