CR 29: Quest-Tracker-Box oben links im HUD

Eine feste Box zeigt durchgehend das aktuelle Ziel im Quest-Log-Ton: eine
Zielzeile, darunter ein Ortshinweis. Sie haengt in player.tscn neben Lexicon
und Pausenmenue — der Spieler existiert in jeder spielbaren Szene, damit ist
die Box ueberall da, ohne dass vierzehn Szenen sie einzeln einhaengen
muessten.

Das Ziel wird bei jeder Aktualisierung frisch abgeleitet, nichts gespeichert.
Rangfolge: gescriptete Szene (Viadukt, Gauntlet, Dreschen zeigen ihr
unmittelbares Lauf-Ziel statt des Tagesfahrplans), dann verbrauchter Slot,
dann Pflicht-Ort aus den laut get_slot_plan() offenen Raeumen, sonst freier
Slot. Die Texte stehen in data/story/raeume.json, also in derselben Datei wie
die Stundenplan-Bezeichnungen aus CR 28 — ein Raum wird an genau einer Stelle
benannt.

Aktualisiert wird ueber slot_changed und day_ended plus einen Sekundentakt
fuer Szenenwechsel und erzwungene Szenen, die kein Signal senden; ein Ziel,
das eine Sekunde nachhinkt, ist billiger als eine zweite Zustandsquelle.

Spoilerfrei wie CR 28: title, beat und forced_scene werden nie angezeigt. An
Tag 9 nachmittags steht deshalb "Hol die Ausruestung aus der Materialkammer."
— das steht so auf Tyrveils Plan, der Hinterhalt bleibt ungenannt.

Nebenbei: Das Debug-Overlay sass an derselben Stelle und ueberlagerte die neue
Box. Es ist Dev-Geruest und weicht dem echten HUD.

Verifiziert mit dev_cr29_probe (18/18, darunter alle 30 Slots auf Spoiler und
auf ein gefuelltes Ziel geprueft) und einem Boot-Check ueber zehn Szenen;
Sonde vor dem Commit geloescht.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-22 18:35:05 +02:00
parent c42140712b
commit 1e9efd084d
9 changed files with 301 additions and 40 deletions

159
scripts/ui/quest_tracker.gd Normal file
View file

@ -0,0 +1,159 @@
extends CanvasLayer
## Quest-Tracker oben links im HUD (CR 29).
##
## Zeigt durchgehend ein kurzes, spoilerfreies Ziel im Quest-Log-Ton:
## eine Zielzeile, darunter optional ein Ortshinweis. Instanz in
## player.tscn — der Spieler existiert in jeder spielbaren Szene, damit
## ist die Box überall da, ohne dass vierzehn Szenen sie einzeln
## einhängen müssten.
##
## **Reine Anzeige, keine zweite Quelle der Wahrheit.** Alles wird bei
## jeder Aktualisierung frisch aus TimeSystem (Tag/Slot/verbraucht) und
## StorySystem (Fahrplan) abgeleitet; die Texte stehen daten-getrieben in
## data/story/raeume.json. Der Tracker speichert nichts und entscheidet
## nichts.
##
## Rangfolge des Ziels:
## 1. **Gescriptete Szene** (Viadukt, Gauntlet, Dreschen) — dort zählt
## das unmittelbare Lauf-Ziel, nicht der Tagesfahrplan.
## 2. **Der Slot ist verbraucht** — Hinweis aufs Tagesende.
## 3. **Ein Pflicht-Ort im Slot** (Unterricht, Materialdienst, Abend bei
## Imogen) — abgeleitet aus den laut Fahrplan offenen Räumen.
## 4. **Freier Slot** — keine Vorgabe.
##
## Nie angezeigt werden title/beat/forced_scene der Tagespläne: Das sind
## Autoren-Notizen und würden kommende Ereignisse verraten. Ein Ziel
## nennt nur Ort und Tätigkeit.
const ROOMS_PATH := "res://data/story/raeume.json"
const REFRESH_SECONDS := 1.0
var _data: Dictionary = {}
var _refresh_remaining := 0.0
var _last_line := ""
@onready var _title_label: Label = $Root/Panel/Margin/Content/TitleLabel
@onready var _line_label: Label = $Root/Panel/Margin/Content/LineLabel
@onready var _hint_label: Label = $Root/Panel/Margin/Content/HintLabel
## Lädt die Ziel-Texte, hört auf Tages- und Slot-Wechsel und zeigt
## sofort das erste Ziel.
func _ready() -> void:
var file := FileAccess.open(ROOMS_PATH, FileAccess.READ)
if file == null:
push_error("Ziel-Texte nicht lesbar: %s" % ROOMS_PATH)
else:
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if parsed is Dictionary:
_data = parsed
else:
push_error("Ziel-Texte sind ungültig: %s" % ROOMS_PATH)
TimeSystem.slot_changed.connect(_on_slot_changed)
TimeSystem.day_ended.connect(_on_day_ended)
refresh()
## Frischt zusätzlich im Sekundentakt auf: Erzwungene Szenen und
## Szenenwechsel melden sich nicht über ein Signal, und ein Ziel, das
## eine Sekunde nachhinkt, ist billiger als eine zweite Zustandsquelle.
func _process(delta: float) -> void:
_refresh_remaining -= delta
if _refresh_remaining > 0.0:
return
_refresh_remaining = REFRESH_SECONDS
refresh()
## Baut das aktuelle Ziel neu und schreibt es in die Box.
func refresh() -> void:
var goal := get_current_goal()
_title_label.text = str(goal.get("title", "Ziel"))
_line_label.text = str(goal.get("line", ""))
var hint := str(goal.get("hint", ""))
_hint_label.text = hint
_hint_label.visible = not hint.is_empty()
_last_line = str(goal.get("line", ""))
## Das aktuelle Ziel als { title, line, hint } — öffentlich, damit Sonden
## es ohne UI prüfen können.
func get_current_goal() -> Dictionary:
var scene_goal := _scene_goal()
if not scene_goal.is_empty():
return scene_goal
if TimeSystem.is_current_slot_used:
return _titled(_data.get("slot_used_quest", {}))
var room_goal := _room_goal()
if not room_goal.is_empty():
return room_goal
return _free_slot_goal()
## Ziel einer gescripteten Szene, erkannt am Dateinamen der laufenden
## Szene; leer, wenn die aktuelle Szene keine ist.
func _scene_goal() -> Dictionary:
var scene := get_tree().current_scene
if scene == null:
return {}
var stem := str(scene.scene_file_path).get_file().get_basename()
var scenes: Dictionary = _data.get("scenes", {})
if not scenes.has(stem):
return {}
var goal: Dictionary = scenes[stem]
return { "title": "Jetzt", "line": str(goal.get("line", "")), "hint": str(goal.get("hint", "")) }
## Ziel aus dem Tagesfahrplan: der erste laut Fahrplan offene Raum, der
## eine eigene Ziel-Zeile trägt. Hof und Aula stehen immer offen und
## sind deshalb nie ein Ziel.
func _room_goal() -> Dictionary:
var rooms: Dictionary = _data.get("rooms", {})
var open_rooms: Array = StorySystem.get_slot_plan(
TimeSystem.day_count, TimeSystem.get_slot_id()).get("rooms", [])
for room_id in open_rooms:
var room: Dictionary = rooms.get(str(room_id), {})
var line := str(room.get("quest", ""))
if line.is_empty():
continue
return {
"title": "Tagesplan — %s" % TimeSystem.get_slot_name(),
"line": line,
"hint": "%s · %s" % [str(room.get("name", "?")), TimeSystem.get_slot_name()],
}
return {}
## Ziel für einen Slot ohne Pflicht-Ort.
func _free_slot_goal() -> Dictionary:
var goal: Dictionary = _data.get("free_slot_quest", {})
var line := str(goal.get("line", "%s"))
if "%s" in line:
line = line % TimeSystem.get_slot_name()
return {
"title": "Tagesplan — %s" % TimeSystem.get_slot_name(),
"line": line,
"hint": str(goal.get("hint", "")),
}
## Setzt einen Standard-Titel auf einen Ziel-Eintrag ohne eigenen.
func _titled(goal: Dictionary) -> Dictionary:
if goal.is_empty():
return _data.get("fallback_quest", { "line": "Sieh dich um.", "hint": "" })
return {
"title": goal.get("title", "Tagesplan"),
"line": str(goal.get("line", "")),
"hint": str(goal.get("hint", "")),
}
## Frischt beim Slot-Wechsel auf.
func _on_slot_changed(_new_slot: int) -> void:
refresh()
## Frischt beim Tageswechsel auf.
func _on_day_ended(_new_day: int) -> void:
refresh()

View file

@ -0,0 +1 @@
uid://dd2yxitvkgx0o