windgeschworen/scripts/ui/debug_overlay.gd
danny ef60c96735 Phase 4a: Unterrichts-Stationen, FactionSystem, Permadeath-Toggle
- training_station.gd: drei Stationen (Kampftraining -> Kraft,
  Landnavigation -> Schnelligkeit im Reiterquadranten; Geschichte & RSC
  -> Verstand im Klassenraum), je +2 auf den Stat (an STAT_MAX geklemmt),
  Rueckmeldung per Sprechblase, Doppel-Eingabe-Schutz
- TimeSystem.try_spend_slot(): erster echter Verbraucher von
  advance_slot() - Vormittag/Nachmittag ruecken vor, der Abend wird als
  verbraucht markiert und blockiert weitere Aktivitaeten bis zum
  Schlafsaal; Slot-Freigabe bei Slot-Wechsel/Reset
- FactionSystem als Fassade ueber neues gespeichertes
  GameState.faction_standings (-100..100, Signal
  faction_standing_changed), Fraktions-ID gezeichnete; Story-Logik folgt
  in 4b/4c
- Permadeath-Toggle im Hauptmenue (fokus-navigierbar, Text synchron);
  GameState.reset() laesst is_permadeath_enabled bewusst unangetastet
  (Menue-Option), Save/Load stellt den Zustand wieder her
- Debug-Overlay: Gezeichnete-Standing sichtbar, F9/F10 verschieben es
  testweise (reine Overlay-Debug-Hilfe ohne Input-Action)
- Headless verifiziert (29 Checks): Slot-Kette Vormittag->Nachmittag->
  Abend->blockiert->Schlafen, Stat-Zuwaechse aller drei Stationen,
  Faction-Signal + Save/Load-Roundtrip, Toggle inkl. Reset- und
  Persistenz-Semantik

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-05 17:01:53 +02:00

104 lines
4.6 KiB
GDScript

extends CanvasLayer
## Debug-Overlay für Phase 0.
##
## Zeigt FPS, das zuletzt benutzte Eingabegerät (Tastatur/Maus, Xbox- oder
## PS5-Controller), die Spielerposition, die aktuelle Kamera-Distanz, den
## Bewegungszustand sowie seit Phase 1b Tages-Slot und Tageszähler aus dem
## TimeSystem und seit Phase 1a die GameState-Werte: Stats,
## Klinge-↔-Herz-Ton-Wert, Beziehungswert zu Imogen und Permadeath-Status.
## Der verdeckte
## Menschlichkeits-Messwert wird laut SPEC bewusst NICHT angezeigt.
## Die provisorische Geräteerkennung wandert in einer späteren Phase in das
## Autoload InputPrompts (dynamische Button-Prompts, SPEC.md Abschnitt 2).
const JOY_MOTION_THRESHOLD := 0.2
const TRACKED_NPC_IDS: Array[String] = ["imogen", "violet", "rhiannon", "wren"]
const PLAYSTATION_NAME_HINTS: Array[String] = [
"ps5", "ps4", "dualsense", "dualshock", "sony", "playstation",
]
@export var player_path: NodePath
var _active_device := "Tastatur/Maus"
var _player: CharacterBody3D
@onready var _info_label: Label = $InfoLabel
## Löst die Spieler-Referenz auf (bevorzugt über den exportierten Pfad,
## sonst über die Gruppe "player") und blendet das Overlay während
## laufender Dialoge aus, damit es nicht über den Sprechblasen liegt.
func _ready() -> void:
_player = get_node_or_null(player_path) as CharacterBody3D
if _player == null:
_player = get_tree().get_first_node_in_group("player") as CharacterBody3D
DialogueSystem.dialogue_started.connect(_on_dialogue_started)
DialogueSystem.dialogue_finished.connect(_on_dialogue_finished)
## Blendet das Overlay bei Dialogbeginn aus.
func _on_dialogue_started(_dialogue_id: String) -> void:
visible = false
## Blendet das Overlay nach Dialogende wieder ein.
func _on_dialogue_finished(_dialogue_id: String) -> void:
visible = true
## Merkt sich das zuletzt benutzte Eingabegerät anhand des Event-Typs;
## Stick-Rauschen unterhalb der Deadzone wird ignoriert. F9/F10
## verschieben testweise das Gezeichneten-Standing (reine Debug-Hilfe des
## Overlays, bewusst ohne Input-Action — fliegt mit dem Overlay raus).
func _input(event: InputEvent) -> void:
if event is InputEventKey and event.pressed and not event.echo:
if event.physical_keycode == KEY_F9:
FactionSystem.adjust_standing(FactionSystem.MARKED_FACTION_ID, -5)
elif event.physical_keycode == KEY_F10:
FactionSystem.adjust_standing(FactionSystem.MARKED_FACTION_ID, 5)
if event is InputEventKey or event is InputEventMouseButton or event is InputEventMouseMotion:
_active_device = "Tastatur/Maus"
elif event is InputEventJoypadButton:
_active_device = _describe_joypad(event.device)
elif event is InputEventJoypadMotion and absf(event.axis_value) > JOY_MOTION_THRESHOLD:
_active_device = _describe_joypad(event.device)
## Baut den Anzeigetext jedes Frame neu auf.
func _process(_delta: float) -> void:
var lines := PackedStringArray()
lines.append("FPS: %d" % Engine.get_frames_per_second())
lines.append("Eingabegerät: %s" % _active_device)
if is_instance_valid(_player):
var pos := _player.global_position
lines.append("Position: (%.1f, %.1f, %.1f)" % [pos.x, pos.y, pos.z])
if _player.has_method("get_camera_zoom"):
lines.append("Kamera-Zoom: %.1f m" % _player.get_camera_zoom())
if _player.has_method("get_movement_state_name"):
lines.append("Bewegung: %s" % _player.get_movement_state_name())
lines.append("Tag %d — %s" % [TimeSystem.day_count, TimeSystem.get_slot_name()])
lines.append("Kraft: %d Schnelligkeit: %d Verstand: %d" % [GameState.strength, GameState.agility, GameState.intellect])
lines.append("Klinge <-> Herz: %+d" % GameState.blade_heart_tone)
var relationship_parts := PackedStringArray()
for npc_id in TRACKED_NPC_IDS:
relationship_parts.append("%s %+d" % [npc_id.capitalize(), RelationshipSystem.get_relationship(npc_id)])
lines.append("Beziehungen: %s" % " ".join(relationship_parts))
lines.append("Gezeichnete-Standing: %+d (F9/F10 zum Testen)" % FactionSystem.get_standing(FactionSystem.MARKED_FACTION_ID))
var npc_states := PackedStringArray()
for npc in get_tree().get_nodes_in_group("npc"):
if npc.has_method("get_state_name"):
npc_states.append("%s: %s" % [str(npc.npc_id).capitalize(), npc.get_state_name()])
if not npc_states.is_empty():
lines.append("NPCs: %s" % " ".join(npc_states))
lines.append("Permadeath: %s" % ("AN" if GameState.is_permadeath_enabled else "AUS"))
_info_label.text = "\n".join(lines)
## Ordnet einen Controller anhand seines Gerätenamens der PS5- oder
## Xbox-Familie zu.
func _describe_joypad(device: int) -> String:
var joy_name := Input.get_joy_name(device).to_lower()
for hint in PLAYSTATION_NAME_HINTS:
if joy_name.contains(hint):
return "PS5-Controller"
return "Xbox-Controller"