windgeschworen/docs/CHANGEREQUESTS.md
danny c42140712b CR 28: Journal zeigt einen echten Stundenplan statt Story-Spoiler
Die Kalenderseite zeigte "Tag N — <Titel aus dem Tagesplan>" und verriet
damit kommende Beats: "Der Hinterhalt" stand an Tag 9, bevor er passiert.

Aus der einen Seite wurden zwei, eine je Akademie-Woche — 10 Tage mal 3 Slots
passen nicht auf ein Blatt. Je Tag eine Kopfzeile mit Wochentag und
Fortschritts-Marke, darunter alle drei Slots in einer Zeile.

Die Faecher kommen aus den laut get_slot_plan() im Slot offenen Raeumen, der
einzigen spoilerfreien Information im Fahrplan. title, beat und forced_scene
sind Autoren-Notizen und werden nirgends angezeigt; die Sonde prueft das fuer
alle zehn Tage einzeln. Neu ist data/story/raeume.json mit Anzeigename und
Stundenplan-Bezeichnung je Raum; Raeume ohne schedule-Eintrag (Hof, Aula,
Schlafsaal, Imogens Zimmer) sind kein Unterricht und tauchen nicht auf.

Tag 1 ist Montag der ersten Woche, Tag 10 Freitag der zweiten. Der
Viadukt-Tag steht als Ankunftstag vor der Zaehlung auf Seite 1 — waehrend des
Viadukts als laufender Tag, danach abgehakt, ueber das bestehende Flag
ankunft_done. Die interne Zaehlung day_count 1-10 bleibt unberuehrt.

Die Faecher sind alphabetisch sortiert statt in der Array-Reihenfolge des
Fahrplans, damit dasselbe Fach an jedem Tag an derselben Stelle steht.

Verifiziert mit dev_cr28_probe (29/29, darunter eine Kreuzprobe ueber alle 30
Slots gegen den Fahrplan) und einem Boot-Check ueber sechs Szenen; Sonde vor
dem Commit geloescht.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-22 18:29:28 +02:00

13 KiB
Raw Blame History

CHANGEREQUESTS.md — Windgeschworen

Hier schreibe ich Änderungen auf, die mir während dem Testen auffallen. Bitte arbeite diese bei jeder Phase vorher ab, sodass hier immer alles erledigt ist.

Erledigte Punkte löschst du bitte, damit diese nicht aus Versehen doppelt gemacht werden. Die erledigten Punkte sollen dann bitte in die Datei CHANGEREQUESTS_DONE.md übertragen werden, mit einer kurzen Anmerkung von dir, wann es geändert wurde und was du genau getan hast.


Neue Change Requests aus dem Akt-1-Testdurchlauf (2026-07-21)

Findings des Autors beim Durchspielen von v1. Priorität vor den Akt-2-CRs weiter unten — das ist Politur am fertigen v1-Umfang.

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 sich rollenspielmäßig lesen, passend zum jeweiligen Raum.

  • Beispiele (Ton, nicht wörtlich vorgeschrieben): Unterrichtsräume außerhalb ihres Slots → „Dieses Fach hast du gerade nicht."; Imogens Zimmer außerhalb der Nacht-Flags → „Die Tür ist abgeschlossen."
  • Umsetzung: REFUSAL_TEXT wird pro room_id daten-getrieben (data/-Datei oder Dictionary-Konstante), Fallback auf einen neutralen Text für nicht gelistete room_ids. Keine Logik-Änderung an _is_open().
  • Akzeptanz: Jede gesperrte Tür zeigt einen zu ihrem Raum passenden, in-Charakter-Text statt der generischen Fahrplan-Meldung; unbekannte room_ids fallen auf einen sinnvollen Standardtext zurück.
  • Betrifft: zone_trigger.gd.

31. Gauntlet-Rad: Kollision, Fremdkörper-Platten, unklare Paddel, fehlende Streben

Autor-Befund beim Testen, vier Symptome — alle im Code verifiziert (spinning_wheel.gd), keine Vermutung:

  • (a) Durchfallen bestätigt — Hauptursache. Die 14 Hüllen-Segmente der Trommel werden mit build_box_mesh() gebaut, das laut obstacle_base.gd ausdrücklich kein Kollisions-Shape erzeugt ("Deko/Silhouetten"). Die rotierende Außenhülle ist rein optisch — man kann überall hindurchlaufen, nicht nur durch die vorgesehene Lücke. Widerspricht der eigenen Spec des Rads („geschlossene, feste Hülle, genau EINE Lücke"). Fix: Segmente brauchen echte Kollision (rotierend mit _pivot), dabei muss die Lücke selbst weiterhin frei bleiben (kein Segment dort).
  • (b) Die zwei „Platten" am Ein-/Ausstieg. Das sind die festen Hüllen-Lippen (build_box-Aufrufe, Zeilen ~82–83) — sie sind nicht Kind von _pivot, drehen sich also nicht mit der Trommel und wirken dadurch wie lose stehende Fremdkörper statt integrierter Rand der Öffnung. Fix: visuell so gestalten/positionieren, dass sie erkennbar zum feststehenden Rahmen der Ein-/Ausstiegsöffnung gehören (z. B. als Türrahmen-Silhouette), nicht wie zufällig platzierte Blöcke.
  • (c) Lila/blauer Balken — Zweck unklar. Die zwei „Paddel" (Color(0.35,0.35,0.5) / Color(0.3,0.4,0.45), gedacht als Dreh-Timing-Referenz laut Doku-Kommentar) lesen sich visuell nicht als Mühlrad-Teile. Fix: entweder holzfarben/materialgleich zur Hülle gestalten (klar als Speichen/Paddel erkennbar) oder Zweck anders kommunizieren (z. B. Warnfarbe NUR wenn sie sich der Lücke nähern).
  • (d) Fehlende Streben rechts und links. Auf den beiden seitlichen Stirnflächen der Trommel (bei z = ±drum_width/2) fehlt jede Speichen-/Rahmen-Geometrie — von der Seite betrachtet fehlt die typische Mühlrad-Silhouette komplett. Fix: sichtbare Speichen-/Rahmenstruktur auf beiden Stirnseiten ergänzen (rotiert mit _pivot, rein dekorativ reicht, keine zusätzliche Kollision nötig).
  • Nicht anfassen: Rotationslogik, Lücken-Timing-Fenster (wheel_entry_window/wheel_exit_window), Mitnahme-Physik (wheel_carry_force) — die Sonden aus CR 7 dazu bleiben gültig.
  • Akzeptanz: Spieler kann nirgends außer durch die Lücke durch die Trommel laufen/fallen; Ein-/Ausstiegsbereich wirkt wie ein integrierter Teil des Rads statt lose Platten; die Paddel sind erkennbar Teil des Mühlrads; von der Seite betrachtet zeigt das Rad eine erkennbare Speichen-Silhouette.

25. Absturz beim Türen-/Zonenwechsel — IN BEOBACHTUNG (Härtung + Forensik drin, 2026-07-21)

Autor: „Das Game crasht öfters, wenn man durch Türen geht" — Symptombild laut Rückfrage: Fenster minimiert sich, Standbild, immer andere Türen.

  • Untersuchungsstand (2026-07-21, Claude): In vier eskalierenden Reproduktions-Aufbauten (headless direkt, Doppel-Trigger im selben Frame, windowed, windowed mit echtem Physik-body_entered und stehender Absage) über 175+ Türwechsel kein Absturz und kein einziger Fehlertext. Die Verdachtsstelle aus der ursprünglichen CR (zone_trigger-await) ist in Godot 4.7 nachweislich still: Coroutinen auf freigegebenen Instanzen brechen stumm ab, gebundene Timer-Signale werden beim Freigeben getrennt, freigegebene Objekte vergleichen sich gleich null. Die gesamte „freed instance"-Fehlerklasse scheidet als Ursache aus.
  • Trotzdem gehärtet (echte, wenn auch stille Fehler):
    1. zone_trigger.gd: Absage-Rücksteller läuft über einen Kind-Timer statt await — kein Zombie-Rest nach dem Wechsel.
    2. dialogue_system.gd + dialogue_box.gd: Stirbt die Szene unter einem laufenden Dialog weg (Auto-Start-Szenen wie Appell/Ankunft können mit einem Türtrigger um denselben Frame rasen), endete der Dialog vorher NIE — die Autoload-Coroutine hing für immer im choose()-Await und legte die Box über die neue Szene. Jetzt endet er sofort und still.
  • Forensik für den nächsten Vorfall: Log-Aufbewahrung auf 30 Dateien erhöht (debug/file_logging/max_log_files) und jeder Türwechsel schreibt eine [tuerwechsel]-Zeile ins Log. Beim nächsten Standbild bitte: Spiel abschießen, dann die neueste Datei aus %APPDATA%/Godot/app_userdata/Windgeschworen/logs/ sichern und hierher — die letzten Zeilen zeigen dann, was unmittelbar vor dem Einfrieren lief.
  • Offen: Ursache unbestätigt. Kandidaten jenseits der Skript-Ebene (Treiber/Vulkan-Stall beim ersten Betreten einer Szene, Fokus-Verlust im Editor-Vollbild) lassen sich erst mit einem echten Log belegen.

24. Primitiven-Austausch in den echten Szenen (Folge-Schritt aus CR 23)

Aufgemacht am 2026-07-21, nachdem CR 23 die Pipeline verifiziert hat. Die Assets liegen sortiert und importiert unter assets/models/, die Rig-Kompatibilität ist bewiesen — jetzt geht es an die Szenen selbst.

  • Umfang: Kapsel-/Box-Primitiven in Hof, Sparringshalle, Aula, Schlafsaal, Lehrträumen usw. durch die importierten Modelle ersetzen. Szene für Szene, nicht alles auf einmal.
  • Charaktere zuerst vorbereiten: Der Basis-Charakter ist EIN Mesh aus Kopf und Körper; unter Kleidung stößt der Körper durch. Quaternius' Readme nennt den Weg — verdeckte Körperteile in Blender entfernen, nur der Kopf wird gebraucht (spart zusätzlich Rechenzeit). Das ist die Voraussetzung für saubere bekleidete NPCs.
  • Animationen anbinden: Die Universal Animation Library deckt die CR-8-Kampfgrammatik ab (Sword_Idle, Sword_Attack, Roll, Punch_Cross, Hit_Chest, Death01) sowie Bewegung (Idle, Walk, Jog_Fwd, Sprint) und Sozialbeats (Sitting_Idle, Idle_Talking). Root-Motion-Variante _rm liegt bereit, falls sie gebraucht wird.
  • Offen zu entscheiden: Die Outfit-Texturen liegen in 4K (~84 MB allein für assets/models/outfits/textures/, insgesamt ~229 MB). ASSETS.md hält fest, dass mehr Auflösung bei diesen flächigen Charakter-Texturen nichts bringt — ein Herunterrechnen auf 1K/2K wäre also verlustfrei fürs Bild und spürbar fürs Repo. Bewusst nicht in CR 23 entschieden.

8-magie. Magie-Ebene des Kampfsystems (ab Akt 2)

Rest von CR 8 — die Sub-CRs 8a–8e sind gebaut (2026-07-19, siehe CHANGEREQUESTS_DONE). Das fertige Kampfsystem und seine dauerhaften Regeln (Encounter-Zonen, gleiche DPR, Waffenskill-Regel) stehen jetzt in SPEC §6, „Kampfsystem".

  • Die Magie-Ebene der Kampf-Grammatik (Siegelkraft / Lesser Magic im Kampf) — existiert erst nach der Bindung, verzahnt mit CR 9 (Bindungs-Achse).
  • Nicht in v1: vor dem Dreschen hat Tyrveil keinen Drachen und damit keine kanalisierbare Magie.

9. Drachen-Bindung als dritte Dialog-Achse (ab Akt 2)

Kaddis-Runde 2.

  • Ab Akt 2 (nach Dreschen + erstem Flug) gibt es neben Klinge/Herz eine dritte Antwort-Sorte, die die Bindung zu Smàladh (neuer verdeckter Wert 0–100) hebt. Existiert erst NACH der Bindung (vorher kein Drache).
  • Zwei getrennte Effekte:
    • Siegelkraft-Stärke skaliert mit der Bindung.
    • Kanalisierungs-Ausdauer (wie lange die Siegelkraft gehalten werden kann, bevor man ausbrennt) skaliert ebenfalls — kanonisch (Kanalisieren laugt aus).
  • Bindungs-Antworten in Smàladhs Ton (Kopf-an-Kopf; dragons/SMÀLADH.md). Zulieferer: Drachenpflege (CR 10).
  • Default (korrigierbar): Wert verdeckt wie der Menschlichkeits-Messwert; Feedback über spürbare Smàladh-Reaktionen.

10. Drachenpflege (Bonding-Aktivität, ab Akt 2)

Kaddis-Runde 2.

  • Nach der Bindung: um Smàladh kümmern — Krallen schärfen, Schuppen säubern, streicheln. Eigene Aktivität (Tagesslot) am Flight Field (locations/outdoor/FLIGHT_FIELD.md).
  • Speist die Bindungs-Achse (CR 9) → Siegelkraft & Kanalisierungs-Ausdauer.
  • Ton-Regel: Smàladh ist kein Schoßtier — er duldet die Pflege erst, dann schätzt er sie; das erste zugelassene Streicheln ist ein echter Meilenstein.
  • Default: kleine Interaktion (leichtes QTE/Rhythmus), einmal pro Tag (Anti-Farming).

13. Eigenes Kartenspiel (Stretch aus CR 13)

Rest-Umfang nach der Umsetzung von Poker und Messerspiel (2026-07-20).

  • Ein eigenes Kartenspiel mit eigenem Regelwerk am Spieltisch der Aula — bewusst als späterer Stretch markiert, kein v1-Ziel.
  • Setzt auf dem fertigen Tisch auf: game_table.gd wählt Spiel, Gegner und Einsatz bereits generisch aus data/minigames/table_games.json; ein neues Spiel braucht einen Eintrag unter games und eine UI-Szene mit einer play()-Coroutine.

Phasen-Plan (Reihenfolge für den Entwickler-Claude)

Status (2026-07-21, Claude): Wellen 0–3 sind komplett abgearbeitet (Phasen 0–11, CR 1–16, CR 8a–8e Kampfsystem, CR 11–13 Flavor) — der v1-Umfang ist inhaltlich beisammen. Zusätzlich erledigt: CR 23 (Asset-Pipeline mit fünf Quaternius-CC0-Packs steht und ist verifiziert).

Offen, in Prioritätsreihenfolge:

  • Politur-Welle CR 17–22 (Findings aus dem Akt-1-Testdurchlauf) — voll spezifiziert, bereit zur Umsetzung, noch nicht dispatcht. Reihenfolge: CR 20 (Bugfix, klein) → CR 18 (Viertes Geschwader) → CR 17 (Poker) → CR 21 (Blätter) → CR 19+22 (Schreibpass, ein Durchgang).
  • CR 24 (Primitiven-Austausch, Folge-Schritt aus CR 23) — zwei offene Autoren-Entscheidungen zuerst klären (Textur-Downscale 4K→1K/2K?, Blender-Trimm-Schritt für den Basis-Körper bestätigen), dann Szene für Szene umsetzen.
  • CR 13-Rest (eigenes Kartenspiel) — Stretch, kein v1-Ziel, keine Eile.
  • Welle 4 (Akt 2, jenseits v1): CR 9, CR 10, CR 8-magie, CR-16-Rest (Camp) — alle setzen die Bindung an Smàladh voraus. Nächster inhaltlicher Schritt davor ist KEIN Code, sondern Story: Akt 2 ist in STORY.md §9 ausdrücklich „noch auszuarbeiten" — ohne ihn hängen diese drei CRs in der Luft.

Vollständige, gewichtete Reihenfolge in Wellen: ROADMAP.md.