windgeschworen/docs/ROADMAP.md
danny 1e9efd084d 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>
2026-07-22 18:35:05 +02:00

158 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ROADMAP.md — Windgeschworen
> Gewichtete Umsetzungs-Reihenfolge über den offenen Backlog aus
> **CHANGEREQUESTS.md**. Dieses Doc ordnet nur — die verbindlichen Details je CR
> stehen weiter in CHANGEREQUESTS.md, der Kanon in SPEC > STORY > WELT. Erledigte
> CRs wandern nach CHANGEREQUESTS_DONE.md; dann hier den Status nachziehen.
>
> Stand: **2026-07-22**. Erledigt: Phasen 0–11, CR 1–8 (8a–8e), CR 11–23,
> CR 26, CR 27, CR 32 — **Wellen 0–3 komplett**, v1 steht inhaltlich. Ein
> zweiter Testdurchlauf hat vier weitere Findings gebracht (**CR 28–31**,
> s. u.) — die Politur ist also noch nicht ganz zu Ende. Offen: **CR 28–31**,
> CR 25 (in Beobachtung), der Primitiven-Austausch **CR 24**, danach Welle 4
> (Akt 2: CR 9/10/8-magie/CR-16-Camp) und das eigene Kartenspiel (Stretch).
## Leitprinzip der Reihenfolge
Erst **Entscheidungs-Blocker räumen** (billig, schaltet Ketten frei), dann
**kleine isolierte Fixes** (stabilisieren den Build), dann den **großen
Kampf-Track** (höchstes Risiko, berührt viele v1-Systeme), dann **Flavor/Content**
auf fertigen Systemen, zuletzt die **Akt-2-Features** (jenseits v1).
## Kritischer Pfad
Der ursprüngliche Bau-Pfad (kleine Fixes → CR-8-Bau → Flavor) ist **vollständig
durchlaufen**; v1 steht inhaltlich.
**Jetzt: Politur-Welle** (CR 17–22 aus dem Akt-1-Testdurchlauf; CR 20 erledigt) — v1 rundschleifen,
bevor Akt 2 aufgemacht wird.
**Danach ist der Engpass kein Code, sondern Story:** **Akt 2 ist in STORY.md §9
ausdrücklich „noch auszuarbeiten"**. CR 9 (Bindungs-Achse), CR 10 (Drachenpflege)
und CR 8-magie hängen alle daran — ohne ausgearbeiteten Akt 2 lässt sich ihr Inhalt
nicht sinnvoll spezifizieren. **Welle 4 beginnt also mit Autoren-Arbeit**, nicht
mit Umsetzung.
---
## Welle 0 — Entscheiden & Fundament (PM/Planung) — ✅ erledigt
Reine Doc-/Design-Arbeit, kein Code. Beide Blocker sind geräumt:
- **CR 6 — zweite Siegelkraft.** ✅ Entschieden & ausspezifiziert; Umsetzung in
Welle 1. **Inhalt später revidiert (CR 32, 2026-07-22):** die zweite Kraft wird
jetzt aus einem Defensiv-Pool gewürfelt statt fest vergeben.
- **CR 8 — Scope geschärft.** ✅ In **Sub-CRs 8a–8e** zerlegt (+ 8-magie für Akt 2),
alle Autoren-Entscheidungen gesetzt (Encounter-Zonen statt Welt-Sandbox;
Grammatik leicht/schwer/Ausweichen/Dodge/Magie/Kombo; Waffenskill pro Waffe ohne
Rohschaden-Bruch; Permadeath raus → CR 16). Details: CHANGEREQUESTS §8.
## Welle 1 — Kleine isolierte Stabilisierer — ✅ erledigt (2026-07-19)
- **CR 6 — Umsetzung des Zweitsignets** (Entscheidung steht, s. Welle 0). Klein,
weil in v1 nur latent: beim Dreschen zusätzlich zum regulären Siegelkraft ein
geheimes zweites hinter eigenem Flag setzen (nicht im normalen Reveal zeigen),
Xaden-erkennt-es-Beat (STORY §5). Betrifft `hatching_grounds.gd` +
`signet_system.gd`. **Revidiert durch CR 32:** beide Kräfte werden gewürfelt
(1. offensiv sichtbar, 2. defensiv geheim), nicht fest vergeben.
- **CR 5 — Tyrveil ins Vierte Geschwader / Violets Staffel.** Klein,
self-contained. Staffel-Kameraden Violet/Rhiannon/Ridoc/Sawyer/Liam,
Staffelführer Dain; wirkt auf Formationen, Sparring-Paarungen, Staffel-Ansehen.
- **CR 14 + CR 15 zusammen — Karten-Cluster.** Aula (Gathering Hall) bauen +
verwaiste Schlafsaal-Tür entfernen (CR 14); Hub-Tor-Anordnung an die
Basgiath-Karte angleichen, Lehrtrakt-Bündelung (CR 15). Maßgeblich ist der Text
in ORTE.md, nicht das Referenzbild. **CR 14 ist Voraussetzung für CR 13.**
- **CR 16 — Permadeath raus → Speicher-/Camp-System.** Permadeath-Verdrahtungen
entkoppeln (Viadukt/Tag-9/Dreschen: „Game Over" → „letzter Spielstand"),
ESC-Menü-Save + Schlafen-Save; Camp erst Akt 2. Sinnvoll **vor** CR 8-Bau, weil
CR 8d ohnehin Tag-9 anfasst.
## Welle 2 — Der große Kampf-Track — ✅ erledigt (2026-07-19)
- **CR 8 — Action-RPG-Kampf-Umbau** nach den Sub-CRs **8a→8b→8c→8d→8e**. Die
dauerhaften Regeln des fertigen Systems stehen jetzt in **SPEC §6,
„Kampfsystem"**. Reichweite = **Encounter-Zonen** (Option B), kein
Welt-Sandbox. Berührt Sparring (ersetzt), Tag-9-Hinterhalt (QTE → echter Kampf),
Movement-Abgrenzung (Viadukt/Gauntlet bleiben Geschicklichkeit). Greybox-First;
gleiche DPR über alle Waffenklassen. **Magie-Kampf (8-magie) erst Akt 2.**
## Welle 3 — Flavor/Content auf fertigen Systemen — ✅ erledigt (2026-07-20)
Setzen auf bereits erledigte Systeme auf (CR 8 nicht nötig).
- ~~**CR 11 — Gefechtskunde-Karte (Devera).**~~ **ERLEDIGT (2026-07-20).**
Klick-Karte mit animierten Truppenbewegungen als `map_question`-Beat im
Unterricht; Buch-1-Zeitfilter eingehalten (Poromiel/Greife offen, Veneni
nur als Anomalien, die mit Wahrheit 1 verzahnen).
- ~~**CR 12 — „Blätter jagen".**~~ **ERLEDIGT (2026-07-20).** Treibende Blätter
im Hof, gefangen mit dem bestehenden Movement; speist Muster-Board und
Lexicon. Vater-Seiten selten und bewusst ohne Wahrheit-2-Enthüllung (eigene
Lexicon-Seite statt Muster-Board).
- ~~**CR 13 — Minispiele mit Einsatz**~~ **ERLEDIGT (2026-07-20).** Poker und
Messerspiel am Spieltisch der Aula, mit Marken, Staffel-Ansehen,
Beziehungswerten und echtem Verletzungsrisiko (Schnelligkeits-Malus). Das
**eigene Kartenspiel** war im CR als Stretch markiert und bleibt offen — es
steht als verschlanktes CR 13 in CHANGEREQUESTS.md.
## Politur-Welle — v1-Feinschliff — Runde 1 abgeschlossen (2026-07-21)
CR 20 (Viadukt-Respawn), CR 18 (Viertes Geschwader), CR 21 (Blätter-Jagd)
bestätigt gut. CR 17/19/22 waren zu knapp spezifiziert/umgesetzt — daraus
entstanden **CR 25** (Türwechsel-Absturz, **in Beobachtung**: 175+ Wechsel
nicht reproduzierbar, Härtung + Log-Forensik ist drin, wartet auf den
nächsten Vorfall mit echtem Log), **CR 26** (Schreibpass-Rest, **erledigt** —
alle 31 fehlenden Dateien geprüft, 15 umgeschrieben nach dem neuen
`docs/STIMMEN.md`) und **CR 27** (Poker → **echtes Texas Hold'em**,
**erledigt** — Hole Cards, Flop/Turn/River, Best-of-N-Showdown, Fixed Limit).
## Politur-Welle — Runde 2 (zweiter Testdurchlauf, 2026-07-21)
Vier weitere Autoren-Findings, alle mit konkreter Code-Diagnose:
- **CR 28** — Journal-Kalenderseite darf keine Story-Beats vorwegnehmen;
echter Stundenplan statt „Tag 1…10". Kanon-Recherche bestätigt: Viadukt =
„Conscription Day", vor der Zählung der zehn Akademie-Tage.
- **CR 29** — neue Quest-Tracker-Box oben links im HUD; Datenquelle
(`StorySystem.get_slot_plan`/`get_forced_scene`) existiert schon.
- **CR 30** — Tür-Absagetexte sollen pro Raum rollenspielmäßig klingen statt
einer generischen Fahrplan-Meldung für alle.
- **CR 31** — Gauntlet-Rad: vier Bugs verifiziert, Hauptursache die
gravierendste — die rotierende Hülle hat laut `build_box_mesh()`-Definition
**gar keine Kollision**, man kann überall durchfallen, nicht nur durch die
vorgesehene Lücke.
## Welle 4 — Akt 2 (jenseits v1)
Greifen erst nach Dreschen + erstem Flug; brauchen die CR-6-Basis.
- **CR 9 — Bindung als dritte Dialog-Achse** (verdeckter Smàladh-Wert 0–100 →
Siegelkraft-Stärke + Kanalisierungs-Ausdauer).
- **CR 10 — Drachenpflege** (Tagesslot am Flight Field) — speist CR 9.
Ton-Regel: Smàladh duldet Pflege erst, dann schätzt er sie.
- **CR 8-magie — Magie-Ebene des Kampfes** (Siegelkraft/Lesser Magic), verzahnt mit
CR 9. Erst nach der Bindung möglich.
- **CR 16 (Rest) — Camp** außerhalb Basgiaths als Speicher-/Schlafpunkt im Feld.
---
## Statusübersicht
| CR | Titel | Welle | Status |
|----|-------|-------|--------|
| 5 | Staffel/Geschwader-Setup | 1 | erledigt (2026-07-19) |
| 6 | Zweite Siegelkraft | 1 | erledigt (2026-07-19, latent; Ausspielung: Akt 3) — **inhaltlich revidiert durch CR 32** |
| 7 | Stehendes Gauntlet-Rad | — | erledigt (2026-07-16) |
| 8 | Kampfsystem Action-RPG (8a–8e) | 2 | **erledigt** (2026-07-19, 8a–8e komplett) |
| 8-magie | Magie-Kampf | 4 (Akt 2) | offen |
| 9 | Bindungs-Achse (Akt 2) | 4 | offen |
| 10 | Drachenpflege (Akt 2) | 4 | offen |
| 11 | Gefechtskunde-Karte | 3 | erledigt (2026-07-20) |
| 12 | Blätter jagen | 3 | erledigt (2026-07-20) |
| 13 | Minispiele (Poker + Messerspiel) | 3 | erledigt (2026-07-20) |
| 13-Rest | Eigenes Kartenspiel | — | offen (Stretch, kein v1-Ziel) |
| 17 | Poker: echte Karten + Figuren am Tisch | Politur | **überholt von CR 27** — Setzrunden-Prototyp fühlte sich nicht wie Poker an, ersetzt durch Texas Hold'em |
| 18 | Viertes Geschwader (Ridoc/Sawyer/Liam/Dain) | Politur | erledigt (2026-07-21) — vier Dialogbäume, vier Figuren im Hof, Staffel-Appell als Gruppenszene; beim Nachtest bestätigt |
| 19 | Stimmen-Schreibpass (Dialoge) | Politur | **teilweise** (2026-07-21) — 11 von 48 Dateien wirklich geprüft und verifiziert; Rest siehe **CR 26** |
| 20 | Viadukt-Respawn-Fix (Bug) | Politur | erledigt (2026-07-21) — Respawn am Checkpoint; beim Nachtest bestätigt |
| 21 | Blätter-Jagd (Black-Flag-Gefühl) | Politur | erledigt (2026-07-21) — beim Nachtest bestätigt |
| 22 | Journal/Lexicon-Texte | Politur | erledigt (2026-07-21) |
| 25 | Absturz bei Türwechseln (Bug) | Politur | **in Beobachtung (2026-07-21)** — nicht reproduzierbar (175+ Wechsel sauber); Härtung + Log-Forensik drin, wartet auf nächsten Vorfall mit Log |
| 26 | Schreibpass-Rest (31 Dateien) | Politur | **erledigt (2026-07-21)** — alle 31 geprüft, 15 umgeschrieben nach STIMMEN.md; Fingerabdruck strukturgleich, 17 erledigte Dateien unangetastet |
| 27 | Poker → Texas Hold'em | Politur | **erledigt (2026-07-21)** — Hole Cards, Flop/Turn/River, vier Setzrunden, wechselnde Blinds, Best-of-7-Showdown |
| 32 | Siegelkräfte offensiv/defensiv (Revision CR 6) | Politur | **erledigt (2026-07-22)** — 43 Signets getaggt, beide Ziehungen gewürfelt, Wiederbeleben restlos raus |
| 23 | Asset-Import-Grundausstattung (Quaternius) | Politur | **erledigt (2026-07-21)** — 296 Modelle sortiert unter `assets/models/`, Rig-Kompatibilität in `scenes/test/asset_pipeline_test.tscn` verifiziert |
| 24 | Primitiven-Austausch in den echten Szenen | Politur | offen — Folge-Schritt aus CR 23, Pipeline steht |
| 28 | Journal-Kalender: Stundenplan statt Spoiler | Politur | **erledigt (2026-07-22)** — zwei Wochen-Seiten, echte Wochentage, Fach je Slot; kein Beat/Titel mehr auf der Seite |
| 29 | Quest-Tracker-Box im HUD | Politur | **erledigt (2026-07-22)** — Box oben links im Player, Ziel aus Fahrplan/Szene abgeleitet, reine Anzeige |
| 30 | Rollenspiel-Absagetexte an Türen | Politur | offen |
| 31 | Gauntlet-Rad: Kollision + Optik | Politur | offen — Hauptursache (keine Hüllen-Kollision) verifiziert |
| 14 | Aula-Bau + Tür-Fix | 1 | erledigt (2026-07-19) |
| 15 | Hub-Layout an Karte | 1 | erledigt (2026-07-19) |
| 16 | Permadeath raus → Save/Camp | 1 (Camp: Akt 2) | erledigt (2026-07-19); Camp-Rest: Akt 2 |