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