windgeschworen/docs/ROADMAP.md
danny 7b8a1a3409 CR 31: Gauntlet-Rad — feste Huelle, Tuerrahmen, Speichen
Hauptfix: Die 14 Huellen-Segmente wurden mit build_box_mesh() gebaut, das
laut obstacle_base bewusst kein Kollisions-Shape erzeugt — die Aussenhuelle
war reine Optik, man lief ueberall hindurch statt nur durch die Luecke. Jedes
Segment ist jetzt ein AnimatableBody3D mit eigenem BoxShape und Kind von
_pivot, dreht also mit. sync_to_physics bleibt aus: die Segmente sollen
blocken, das Mitnehmen macht weiterhin allein wheel_carry_force, sonst haette
die Huelle den Laeufer zusaetzlich geschoben und die CR-7-Balance
verfaelscht. Die Luecke bleibt frei, weil die Segmentschleife sie ohnehin
aussparte.

Die beiden festen Lippen bleiben, wo sie sind — sie sind die Kante, ueber die
man springt — bekommen aber einen feststehenden Rahmen aus zwei Pfosten und
Sturz, rein dekorativ und nicht Kind von _pivot. Im Rendering liest sich die
Lippe jetzt als Schwelle einer Toroeffnung statt als loser Block. Die Paddel
tragen die Holztoene der Huelle. Auf beiden Stirnseiten je drei Balken durch
die Mitte plus Nabe, ohne Kollision — von der Seite zeigt das Rad jetzt eine
erkennbare Muehlrad-Silhouette.

Zwei Fehlschlaege waren meine Pruefer, nicht der Code: AnimatableBody3D erbt
von StaticBody3D, mein Rahmen-Test schlug deshalb auf die eigenen Segmente
an. Und ein Testkoerper, der radial gegen die Huelle drueckt, rutscht an der
tangentialen Flaeche entlang bis in die Luecke — korrektes Verhalten, aber
als Loch fehlgedeutet. Der Nachweis laeuft darum ueber Strahlen, die nicht
rutschen.

Rotationslogik, Ein-/Ausstiegsfenster, Mitnahme-Physik und Sturz-Bedingung
sind zeichengleich unveraendert; die CR-7-Sonden bleiben gueltig.

Verifiziert mit dev_cr31_probe (20/20) und dev_cr31_solid (4/4: 149 Strahlen
rundum blocken ausnahmslos, alle neun in der Luecke gehen durch, die Luecke
wandert mit), einem Boot-Check ueber zehn Szenen inklusive aller fuenf
Terrassen und drei gerenderten Ansichten; Sonden vor dem Commit geloescht.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-23 06:19:26 +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 | **erledigt (2026-07-22)** — sieben eigene Texte in `raeume.json`, Fallback für unbekannte room_ids, `_is_open()` unverändert |
| 31 | Gauntlet-Rad: Kollision + Optik | Politur | **erledigt (2026-07-22)** — Hülle blockt (149 Strahlen), Türrahmen, Holzfarben, Speichen; Rotation/Fenster/Mitnahme unangetastet |
| 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 |