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

118 lines
3.9 KiB
GDScript

extends Node
## Nerven-/Fokus-System (CR-002 §8): koppelt Live-Tode ans Klettern.
##
## nerve steigt bei Rival-Stürzen in Sicht, Drachen-Ablenkung und beim
## bewussten Blick nach unten (Kamera-Pitch unter Schwelle oder
## look_down-Action, nur in der Höhe). Hoher nerve verschlechtert den
## Griff (grip_drain_factor) und verstärkt Balance-Drift (drift_factor).
## Gegenmittel: Steady/Atmen halten (Strg / L2) senkt nerve, sperrt aber
## die Steuerung — bewusster Zeit-Trade-off am Hang. Über der
## Panik-Schwelle ist Steady für panic_lockout Sekunden blockiert.
signal nerve_state_changed(value: float)
@export var nerve_max := 100.0
@export var nerve_on_rival_fall := 25.0
@export var nerve_on_distraction := 15.0
@export var nerve_look_down_rate := 12.0
@export var nerve_calm_rate := 25.0
@export var nerve_decay_rate := 2.0
@export var nerve_grip_penalty := 1.5
@export var nerve_panic_threshold := 85.0
@export var panic_lockout := 2.5
var nerve := 0.0
var is_steadying := false
var _player: CharacterBody3D
var _course_min_x := -20.0
var _panic_timer := 0.0
var _has_steady_lock := false
var _bar: ProgressBar
## Verknüpft den Spieler und die Kurs-Grenze (x, ab der der Parcours
## beginnt) und baut die HUD-Leiste.
func setup(player: CharacterBody3D, course_min_x: float) -> void:
_player = player
_course_min_x = course_min_x
_build_hud()
## Erhöht den Nerven-Wert (Rival-Sturz, Ablenkung).
func add_nerve(amount: float) -> void:
_set_nerve(nerve + amount)
## Griff-Malus: 1.0 (ruhig) bis 1.0 + nerve_grip_penalty (Panik).
func grip_drain_factor() -> float:
return 1.0 + nerve / nerve_max * nerve_grip_penalty
## Drift-Malus für Balance-Hindernisse (halb so stark wie der Griff-Malus).
func drift_factor() -> float:
return 1.0 + nerve / nerve_max * nerve_grip_penalty * 0.5
## Treibt Blick-nach-unten, Steady und den langsamen Abbau an.
func _physics_process(delta: float) -> void:
if _player == null or DialogueSystem.is_dialogue_active:
return
_panic_timer = maxf(_panic_timer - delta, 0.0)
var is_in_course: bool = _player.global_position.x > _course_min_x or _player.global_position.y > 2.0
if is_in_course and _player.global_position.y > 4.0 and _is_looking_down():
_set_nerve(nerve + nerve_look_down_rate * delta)
var wants_steady := Input.is_action_pressed("steady") and is_in_course and _panic_timer <= 0.0
if wants_steady and (not _player.is_control_locked() or _has_steady_lock):
if not _has_steady_lock:
_player.set_control_locked(true)
_has_steady_lock = true
is_steadying = true
_set_nerve(nerve - nerve_calm_rate * delta)
else:
if _has_steady_lock:
_player.set_control_locked(false)
_has_steady_lock = false
is_steadying = false
_set_nerve(nerve - nerve_decay_rate * delta)
## Setzt den Nerven-Wert geklemmt, pflegt Panik-Sperre und HUD und meldet
## die Änderung.
func _set_nerve(value: float) -> void:
var clamped := clampf(value, 0.0, nerve_max)
if is_equal_approx(clamped, nerve):
return
if clamped >= nerve_panic_threshold and nerve < nerve_panic_threshold:
_panic_timer = panic_lockout
nerve = clamped
_bar.value = nerve
_bar.visible = nerve > 0.5
nerve_state_changed.emit(nerve)
## Erkennt den bewussten Blick nach unten (Kamera-Pitch oder Action).
func _is_looking_down() -> bool:
if Input.is_action_pressed("look_down"):
return true
return _player.get_camera_pitch() < -0.85
## Baut die schmale orange Nerven-Leiste über der Griff-Anzeige.
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
_bar = ProgressBar.new()
_bar.set_anchors_preset(Control.PRESET_CENTER_BOTTOM)
_bar.position += Vector2(-150, -66)
_bar.custom_minimum_size = Vector2(300, 10)
_bar.max_value = nerve_max
_bar.show_percentage = false
_bar.modulate = Color(1.0, 0.55, 0.2)
_bar.visible = false
root.add_child(_bar)
layer.add_child(root)
add_child(layer)