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

134 lines
4 KiB
GDScript

extends Node
## Griff-/Stamina-System des Gauntlet (CR-002 §2) — erweitert das
## bestehende Phase-1-Klettersystem, statt es zu ersetzen.
##
## Der Griff (Tyrveil-Startwert grip_max) entleert sich, solange Tyrveil
## im Parcours unterwegs ist und nicht auf einem Kies-Pfad rastet; das
## Nerven-System skaliert den Verbrauch (grip_drain_factor). Auf
## Rast-Zonen (Gruppe gauntlet_rest) regeneriert der Griff. Leerer Griff
## bedeutet Fehlgriff -> climber_fell (das Seilfang-System übernimmt).
## Zusätzlich sperrt der Ernstlauf das Absteigen: Wer mehr als
## descend_tolerance unter die Höhe des zuletzt erreichten Kies-Pfads
## fällt, gilt als gestürzt (kein Abklettern, kein Aufgeben).
signal climber_fell
signal grip_changed(current: float, maximum: float)
@export var grip_max := 100.0
@export var grip_drain_rate := 3.5
@export var grip_regen_rate := 30.0
@export var descend_tolerance := 4.0
var grip := 100.0
var _player: CharacterBody3D
var _nerve: Node
var _mode: Node
var _course_min_x := -20.0
var _progress_height := 0.0
var _bar: ProgressBar
## Verknüpft Spieler, Nerven-System und Modus und baut die HUD-Leiste.
func setup(player: CharacterBody3D, nerve_system: Node, gauntlet_mode: Node, course_min_x: float) -> void:
_player = player
_nerve = nerve_system
_mode = gauntlet_mode
_course_min_x = course_min_x
grip = grip_max
_build_hud()
## Merkt die Höhe des zuletzt erreichten Kies-Pfads (Descent-Sperre im
## Ernstlauf).
func set_progress_height(height: float) -> void:
_progress_height = maxf(_progress_height, height)
## Füllt den Griff wieder auf (Respawn).
func reset_grip() -> void:
grip = grip_max
_progress_height = 0.0
_update_bar()
## Entleert oder regeneriert den Griff und prüft die Descent-Sperre.
func _physics_process(delta: float) -> void:
if _player == null or DialogueSystem.is_dialogue_active:
return
var is_in_course: bool = _player.global_position.x > _course_min_x or _player.global_position.y > 2.0
if not is_in_course:
_apply_grip(grip + grip_regen_rate * delta)
return
if _mode != null and _mode.is_exam() \
and _player.global_position.y < _progress_height - descend_tolerance:
_fall()
return
if _is_resting():
_apply_grip(grip + grip_regen_rate * delta)
return
var drain := grip_drain_rate
if _nerve != null:
drain *= _nerve.grip_drain_factor()
_apply_grip(grip - drain * delta)
if grip <= 0.0:
_fall()
## Prüft, ob Tyrveil auf einer Rast-Zone (Kies-Pfad, Fuß) steht.
func _is_resting() -> bool:
for zone in get_tree().get_nodes_in_group("gauntlet_rest"):
if zone.overlaps_body(_player):
return true
return false
## Griff leer oder Descent-Sperre gerissen: Sturz melden und auffüllen.
func _fall() -> void:
grip = grip_max
_progress_height = 0.0
_update_bar()
climber_fell.emit()
## Setzt den Griff geklemmt und aktualisiert die Anzeige.
func _apply_grip(value: float) -> void:
var clamped := clampf(value, 0.0, grip_max)
if is_equal_approx(clamped, grip):
return
grip = clamped
_update_bar()
grip_changed.emit(grip, grip_max)
## Aktualisiert die Leiste (rot, wenn der Griff knapp wird).
func _update_bar() -> void:
_bar.value = grip
_bar.visible = grip < grip_max - 0.5
_bar.modulate = Color(0.85, 0.25, 0.2) if grip < grip_max * 0.3 else Color(0.6, 0.8, 0.55)
## Baut die Griff-Leiste unten mittig.
func _build_hud() -> void:
var layer := CanvasLayer.new()
layer.layer = 3
var root := Control.new()
root.set_anchors_preset(Control.PRESET_FULL_RECT)
root.mouse_filter = Control.MOUSE_FILTER_IGNORE
var caption := Label.new()
caption.set_anchors_preset(Control.PRESET_CENTER_BOTTOM)
caption.position += Vector2(-150, -52)
caption.text = "Griff"
caption.add_theme_font_size_override("font_size", 14)
root.add_child(caption)
_bar = ProgressBar.new()
_bar.set_anchors_preset(Control.PRESET_CENTER_BOTTOM)
_bar.position += Vector2(-150, -34)
_bar.custom_minimum_size = Vector2(300, 16)
_bar.max_value = grip_max
_bar.value = grip
_bar.show_percentage = false
_bar.visible = false
root.add_child(_bar)
layer.add_child(root)
add_child(layer)