From 1e9efd084df2fd9ca2e0f02ee2165433707bab21 Mon Sep 17 00:00:00 2001 From: danny Date: Wed, 22 Jul 2026 18:35:05 +0200 Subject: [PATCH] CR 29: Quest-Tracker-Box oben links im HUD MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- data/story/raeume.json | 34 ++++--- docs/CHANGEREQUESTS.md | 22 ----- docs/CHANGEREQUESTS_DONE.md | 46 +++++++++ docs/ROADMAP.md | 2 +- scenes/player.tscn | 9 +- scenes/ui/debug_overlay.tscn | 4 +- scenes/ui/quest_tracker.tscn | 64 +++++++++++++ scripts/ui/quest_tracker.gd | 159 ++++++++++++++++++++++++++++++++ scripts/ui/quest_tracker.gd.uid | 1 + 9 files changed, 301 insertions(+), 40 deletions(-) create mode 100644 scenes/ui/quest_tracker.tscn create mode 100644 scripts/ui/quest_tracker.gd create mode 100644 scripts/ui/quest_tracker.gd.uid diff --git a/data/story/raeume.json b/data/story/raeume.json index 935383b..ad8dee7 100644 --- a/data/story/raeume.json +++ b/data/story/raeume.json @@ -1,6 +1,6 @@ { - "design_note": "CR 28: Anzeige-Namen der Räume und ihre Stundenplan-Bezeichnung. Die Fahrplan-Rohdaten (welcher Raum in welchem Slot offen ist) stehen weiter in data/story/days/ — hier steht nur, wie ein Raum HEISST. Ein leeres schedule-Feld bedeutet: Der Raum ist kein Stundenplan-Eintrag (Hof, Aula, Schlafsaal stehen immer offen; Imogens Zimmer steht in keinem Plan, das ist privat).", - "spoiler_note": "Auf der Stundenplan-Seite darf ausschließlich stehen, was Tyrveil vorher selbst wüsste: Fach und Ort. Die Felder title/beat/forced_scene aus den Tagesplänen sind Autoren-Notizen und verraten kommende Ereignisse — sie werden hier bewusst NICHT angezeigt.", + "design_note": "CR 28/29: Anzeige-Namen der Räume, ihre Stundenplan-Bezeichnung und ihre Ziel-Zeile für den Quest-Tracker. Die Fahrplan-Rohdaten (welcher Raum in welchem Slot offen ist) stehen weiter in data/story/days/ — hier steht nur, wie ein Raum HEISST und wie ein Ziel dorthin klingt. Ein leeres schedule-Feld bedeutet: kein Stundenplan-Eintrag (Hof, Aula, Schlafsaal stehen immer offen; Imogens Zimmer steht in keinem Plan, das ist privat).", + "spoiler_note": "Weder Stundenplan noch Quest-Tracker dürfen kommende Ereignisse verraten. Die Felder title/beat/forced_scene aus den Tagesplänen sind Autoren-Notizen und werden nirgends angezeigt — ein Ziel nennt immer nur Ort und Tätigkeit, so wie Tyrveil sie vorher selbst wüsste.", "weekdays": ["Montag", "Dienstag", "Mittwoch", "Donnerstag", "Freitag"], "week_label": "Woche %d", "arrival_day_name": "Ankunftstag", @@ -11,14 +11,24 @@ "evening": "Ab" }, "rooms": { - "courtyard": { "name": "Hof", "schedule": "" }, - "aula": { "name": "Aula", "schedule": "" }, - "dormitory": { "name": "Schlafsaal", "schedule": "" }, - "imogen_room": { "name": "Imogens Zimmer", "schedule": "" }, - "rotunda": { "name": "Rotunde", "schedule": "Drachenkunde" }, - "sparring_hall": { "name": "Sparringshalle", "schedule": "Sparring" }, - "battle_brief": { "name": "Hörsaal", "schedule": "Gefechtskunde" }, - "history_class": { "name": "Kerzensaal", "schedule": "Geschichte" }, - "material_room": { "name": "Materialkammer", "schedule": "Materialdienst" } - } + "courtyard": { "name": "Hof", "schedule": "", "quest": "" }, + "aula": { "name": "Aula", "schedule": "", "quest": "" }, + "dormitory": { "name": "Schlafsaal", "schedule": "", "quest": "Schlaf dich aus." }, + "imogen_room": { "name": "Imogens Zimmer", "schedule": "", "quest": "Sei nach der letzten Glocke bei Imogen." }, + "rotunda": { "name": "Rotunde", "schedule": "Drachenkunde", "quest": "Geh zur Drachenkunde." }, + "sparring_hall": { "name": "Sparringshalle", "schedule": "Sparring", "quest": "Geh zum Sparring." }, + "battle_brief": { "name": "Hörsaal", "schedule": "Gefechtskunde", "quest": "Geh zur Gefechtskunde." }, + "history_class": { "name": "Kerzensaal", "schedule": "Geschichte", "quest": "Geh zur Geschichtsstunde." }, + "material_room": { "name": "Materialkammer", "schedule": "Materialdienst", "quest": "Hol die Ausrüstung aus der Materialkammer." } + }, + "scenes": { + "viaduct": { "line": "Erreiche das andere Ende des Viadukts.", "hint": "Der Wind steht quer. Wren läuft vor dir." }, + "gauntlet": { "line": "Komm oben an.", "hint": "Sechs Terrassen. Die Zeit läuft mit." }, + "hatching_grounds": { "line": "Geh in den Kreis.", "hint": "Sie prüfen jeden, der hineingeht." }, + "epilogue": { "line": "Sieh dich um.", "hint": "" }, + "combat_testground": { "line": "Übe die Grammatik des Kampfes.", "hint": "Testgelände" } + }, + "free_slot_quest": { "line": "Nutz den %s, wie du willst.", "hint": "Kein Unterricht angesetzt." }, + "slot_used_quest": { "line": "Für heute ist genug getan.", "hint": "Der Tag endet dort, wo du schläfst." }, + "fallback_quest": { "line": "Sieh dich in Basgiath um.", "hint": "" } } diff --git a/docs/CHANGEREQUESTS.md b/docs/CHANGEREQUESTS.md index 6c76238..5019a4c 100644 --- a/docs/CHANGEREQUESTS.md +++ b/docs/CHANGEREQUESTS.md @@ -11,28 +11,6 @@ > Findings des Autors beim Durchspielen von v1. **Priorität vor den Akt-2-CRs > weiter unten** — das ist Politur am fertigen v1-Umfang. -## 29. Quest-Tracker-Box oben links im HUD -> Autor-Wunsch: eine feste UI-Box oben links zeigt die aktuelle „Quest" — in -> Akt 1 z. B. welches Fach ansteht, oder Gauntlet/Viadukt/Materialraum als -> Ziel, im klassischen Quest-Log-Ton. -- **Inhalt pro Situation:** kurze Zielzeile im Imperativ, wie ein Quest-Log - ("Geh zum Unterricht: Gefechtskunde (Nachmittag)", "Erreiche das Ende des - Viadukts", "Hol Übungswaffen im Materialraum"), optional ein Ortshinweis - darunter. -- **Datenquelle:** `StorySystem.get_slot_plan()` / `get_forced_scene()` liefern - die Rohdaten bereits (Fahrplan pro Tag/Slot) — keine neuen Daten nötig, nur - eine Text-Zuordnung pro Raum/Szene-ID. -- **Verhalten:** aktualisiert sich beim Slot-/Tageswechsel und bei erzwungenen - Szenen (Hinterhalt, Gauntlet, Dreschen); während gescripteter Sequenzen - (Viadukt, Gauntlet-Lauf) zeigt sie das unmittelbare Lauf-Ziel, nicht den - Tagesfahrplan. -- **Akzeptanz:** Box ist durchgehend sichtbar (deaktivierbar? — Default: immer - an), zeigt zu jedem Zeitpunkt ein aktuelles, spoilerfreies Ziel passend zum - Fahrplan/zur aktuellen Szene; keine doppelte Quelle der Wahrheit zum - Fahrplan (reine Anzeige, kein neuer Zustand). -- **Betrifft:** neues HUD-Element (vergleichbar mit dem bestehenden - Debug-Overlay-Aufbau), liest aus `StorySystem` + `TimeSystem`. - ## 30. Rollenspiel-taugliche Absagetexte an geschlossenen Türen > Autor: Die generische Absage „Laut Fahrplan gerade geschlossen." (aktuell > EIN Text für alle gesperrten Türen, `zone_trigger.gd::REFUSAL_TEXT`) soll diff --git a/docs/CHANGEREQUESTS_DONE.md b/docs/CHANGEREQUESTS_DONE.md index ec53f83..c36efbb 100644 --- a/docs/CHANGEREQUESTS_DONE.md +++ b/docs/CHANGEREQUESTS_DONE.md @@ -3,6 +3,52 @@ > Abgearbeitete Change Requests aus CHANGEREQUESTS.md, mit Datum und > Anmerkung, was geändert wurde. +## 2026-07-22 — CR 29: Quest-Tracker-Box oben links im HUD + +**Request:** CHANGEREQUESTS §29 — eine feste Box oben links zeigt das +aktuelle Ziel im Quest-Log-Ton, abgeleitet aus dem bestehenden Fahrplan. +Reine Anzeige, keine zweite Quelle der Wahrheit. + +**Wo die Box hängt:** in `player.tscn`, neben Lexicon und Pausenmenü. +Der Spieler existiert in jeder spielbaren Szene — damit ist die Box +überall da, ohne dass vierzehn Szenen sie einzeln einhängen müssten. + +**Rangfolge des Ziels** (jedes Mal frisch abgeleitet, nichts gespeichert): +1. **Gescriptete Szene**, erkannt am Dateinamen der laufenden Szene — + Viadukt, Gauntlet, Dreschen zeigen ihr unmittelbares Lauf-Ziel + („Erreiche das andere Ende des Viadukts.", „Komm oben an.") statt des + Tagesfahrplans. +2. **Slot verbraucht** → Hinweis aufs Tagesende. +3. **Pflicht-Ort im Slot** → aus den laut `get_slot_plan()` offenen + Räumen: „Geh zur Gefechtskunde." mit Ortshinweis „Hörsaal · + Vormittag". +4. **Freier Slot** → keine Vorgabe. + +Die Ziel-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 über `slot_changed` und +`day_ended` plus einen Sekundentakt für 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 Ausrüstung aus +der Materialkammer." — das steht so auf Tyrveils Plan, der Hinterhalt +bleibt ungenannt. Die Sonde prüft alle 30 Slots einzeln. + +**Nebenbei aufgeräumt:** Das Debug-Overlay saß an derselben Stelle oben +links und überlagerte die neue Box. Es ist Dev-Gerüst und weicht dem +echten HUD — im Screenshot verifiziert, es beginnt jetzt darunter. + +**Verifikation:** Sonde `dev_cr29_probe` 18/18 — Box hängt im Player und +ist sichtbar; Unterrichtsziel mit Ortshinweis; Slot-Wechsel aktualisiert +sofort; verbrauchter Slot zeigt den Tagesabschluss; Materialdienst statt +Hinterhalt-Spoiler; **über alle 30 Slots kein Beat-, Titel- oder +Szenen-Name** und **zu jedem Zeitpunkt ein gefülltes Ziel**; Viadukt und +Gauntlet zeigen ihr Lauf-Ziel statt des Fahrplans; der Tracker schreibt +weder Flags noch steuert er die Zeit (Quelltext-Prüfung). Boot-Check +über zehn Szenen fehlerfrei. Sonde vor dem Commit gelöscht. + ## 2026-07-22 — CR 28: Journal-Stundenplan statt Kalender mit Spoilern **Request:** CHANGEREQUESTS §28 — die Kalenderseite zeigte „Tag N — 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() diff --git a/scripts/ui/quest_tracker.gd.uid b/scripts/ui/quest_tracker.gd.uid new file mode 100644 index 0000000..8670d4c --- /dev/null +++ b/scripts/ui/quest_tracker.gd.uid @@ -0,0 +1 @@ +uid://dd2yxitvkgx0o