windgeschworen/docs/CHANGEREQUESTS.md
danny 3381993b71 CR 17: Poker mit echten Karten und Figuren am Tisch
Poker lief bisher ueber Menue-Optionen und fuehlte sich nicht wie Poker an.
Jetzt liegt ein echtes Blatt auf dem Tisch.

CardDeck mischt aus data/minigames/cards.json ein volles 52er-Blatt und
bewertet fuenf Karten nach den echten Poker-Raengen — hohe Karte bis Straight
Flush, inklusive kleiner Strasse mit tiefem Ass und Stichentscheid bei
gleicher Kategorie. Bewusst ohne Godot-Knoten, damit die Rechnung direkt
pruefbar ist.

Echte Setzrunden: beide bekommen fuenf Karten, die des Gegners liegen
verdeckt. Der Spieler eroeffnet, der Gegner antwortet mit eigener
Entscheidung — er schaetzt sein Blatt nach seinem skill ein und erhoeht mit
schwachem Blatt nur, wenn er blufft. Danach Showdown mit benanntem Rang.

card_view zeigt die PNG aus assets/ui/cards/, sobald sie da ist, und zeichnet
sonst eine Platzhalter-Karte aus Rechteck, Wert und Farbzeichen. Ein README
im Zielordner dokumentiert die Benennung. Der Bau hat nicht auf die Assets
gewartet, und mit ihnen wird es nur huebscher, nicht anders.

table_seating fuehrt den gewaehlten Gegner sichtbar zum runden Tisch und
setzt ihn hin; danach gehen alle zurueck. Dealer-Regel wie gefordert: spielt
jemand anderes, dealt Ridoc; spielt Ridoc selbst, dealt er sich selbst und
belegt nur den Gegnerplatz. Die Sitzordnung greift vor beiden Spielen, also
auch vorm Messerspiel.

Beim Bauen gefunden: die erste Fassung sammelte die finished-Signale mehrerer
Tweens und wartete sie nacheinander ab — war der erste schon durch, brach das
await ab. Die Sonde meldete trotzdem gruen, weil die Endpositionen stimmten;
erst das Fehlerprotokoll zeigte es. Jetzt laeuft je Phase ein einziger
paralleler Tween.

Verifiziert mit dev_cr17_probe (41/41) und einem Boot-Check ueber zehn
Szenen, Log ohne Laufzeitfehler; Sonde vor dem Commit geloescht.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-21 19:07:36 +02:00

11 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.

19. Stimmen-Schreibpass — Dialoge klingen „geschrieben", nicht gesprochen

Autor: Violet klingt nicht wie Violet, Imogen ist gegenüber Tyrveil zu abgedroschen, Xaden ist am schlimmsten.

Ursachen-Befund (wichtiger als die Einzelzeilen): Die Dialoge geben die Beschreibungen aus den Figuren-Akten wieder, statt sie zu spielen. Wo die Akte sagt „Tyrveil kennt Xadens Geheimnisse", sagt die Zeile wörtlich „Du kennst meine Geheimnisse". Die Charakter-Bibel ist in den Mund der Figuren gewandert.

Die sechs Anti-Muster (alle belegt in xaden_intro.json und cassian_ambush_choice.json):

  1. Selbst-narrierte Gefühle — „…und erst mal eine Wand angestarrt", „dass ich gerade fast gelächelt habe". Die Figur erzählt ihren Gefühlszustand, statt ihn zu zeigen. Verstößt frontal gegen Xadens „nie sentimental" (CHARACTERS.md).
  2. Die Zeile erklärt ihre eigene Pointe — „Du weißt, wie ich das meine.", „…du weißt inzwischen, wie der Satz endet." Erst landet der Satz, dann erklärt die Figur, dass er gelandet ist. Tötet den Subtext.
  3. Rhetorische Symmetrie / Monolog-Rhythmus — „Ein Jahr, Tyr. Ein Jahr mehr hätte ich…", „Gut, dass du da bist. Nicht gut, DASS du da bist." Anapher und Antithese sind Bühnensprache. Xaden soll halbe Sätze sprechen, „die der andere zu Ende denkt".
  4. Beziehungs-Exposition — „Du kennst meine Wege, du kennst meine Geheimnisse". Zwei Männer, die wie Brüder aufwuchsen, rezitieren einander nicht ihre Beziehung. Das ist Exposition für den Spieler im Mund der Figur.
  5. Das Thema laut aussprechen — Tyrveils „Ich bin nicht das Wetter, Cassian." Die Metapher des Gegners aufgreifen und widerlegen ist Debattierklub, kein Gespräch. TYRVEIL.md verlangt „lieber ein knapper Satz mit Doppelboden als drei erklärende".
  6. Meta-Callback — Cassian behandelt sein eigenes Motiv als bekannten Spruch („du weißt inzwischen, wie der Satz endet"). Das zwinkert dem Spieler zu und bricht die Figur.
  • Auftrag: Alle Dialogbäume in data/dialogue/ gegen diese sechs Muster durchgehen und neu schreiben — Xaden zuerst und am gründlichsten, dann Violet und Imogen. Stimmen-Quellen: die Akten in humans/ + CHARACTERS.md.
  • Faustregeln: Kürzen ist fast immer die Lösung. Was eine Figur fühlt, gehört in das, was sie tut oder verschweigt — nicht in ihre Zeile. Was beide wissen, sagt keiner laut. Pointen bleiben unkommentiert stehen.
  • Akzeptanz: Keine Zeile im Bestand erfüllt noch eines der sechs Muster; Xadens Auftritte kommen mit hörbar weniger Worten aus; ein Blindtest „wer spricht hier?" ist bei Xaden/Violet/Imogen/Ridoc/Tyrveil eindeutig beantwortbar.
  • Wichtig: Reiner Schreibpass — keine Story-Fakten, Flags, Effekte oder Verzweigungen ändern (Ton ≠ Ausgang, STORY §6).

21. „Blätter jagen": echte Hatz statt driftendes Pickup

Delta gegen die CR-12-Umsetzung. Vorbild: die Sea-Shanty-Seiten aus AC4 Black Flag.

  • Befund: loose_page.gd lässt jedes Blatt in einer zufälligen, konstanten Richtung treiben und am Kreisrand umspringen — es reagiert nicht auf den Spieler. Dadurch ist es ein bewegtes Pickup, keine Jagd.
  • Soll: Das Blatt reagiert auf die Annäherung — kommt der Spieler nah, reißt eine Böe es weg, es wirbelt hoch, wechselt die Richtung. Der Reiz ist die Hatz mit Beinahe-Griffen.
  • Harte Balancing-Regel (Autor): Es muss trotzdem erreichbar bleiben. Die Flucht darf das Blatt nicht unfangbar machen — z. B. nachlassende Böen, Abklingzeit zwischen Ausweichern, Sacken nach einer Flucht, oder ein Fenster, in dem Slide/Sprint/Sprung sicher zugreifen. Jede Jagd endet einholbar.
  • Akzeptanz: Ein Blatt weicht bei Annäherung spürbar aus (nicht nur konstantes Driften); mehrere Beinahe-Griffe pro Jagd sind normal; keine Jagd ist unabschließbar — mit dem bestehenden Movement ist jedes Blatt sicher fangbar; Fund-Typen und Belohnungen aus CR 12 bleiben unverändert.
  • Betrifft: loose_page.gd (Flugverhalten), ggf. page_spawner.gd.

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.

22. Journal/Lexicon-Texte überarbeiten

„Das Journal ist noch cringe geschrieben."

  • Die Texte im Lexicon (Fach-Seiten, Personen & Gerüchte, Codex-Einträge, Kalender- und Abschlusszeilen) gegen dieselben Anti-Muster wie CR 19 prüfen — vor allem Muster 1 (selbst-narrierte Gefühle) und 2 (die Zeile erklärt ihre Pointe).
  • Ton-Setzung: Das Lexicon ist Tyrveils Buch — es darf seine Stimme haben (trocken, untertrieben, Galgenhumor; TYRVEIL.md), statt neutral-erklärend oder pathetisch zu sein.
  • Akzeptanz: Kein Eintrag erklärt dem Spieler seine eigene Bedeutung; die Einträge sind hörbar aus Tyrveils Perspektive geschrieben; Fakten und Freischalt-Logik bleiben unverändert.
  • Betrifft: data/lexicon/subjects.json, data/story/codex.json, die Kalender-/Seitentexte in scripts/ui/lexicon.gd.
  • Kann als ein Schreibpass zusammen mit CR 19 laufen.

Neue Change Requests aus der Autoren-Sitzung (Story/Welt-Ausbau)

Nur noch offene Punkte — abgeglichen mit CHANGEREQUESTS_DONE.md. Der 10-Tage-Zyklus (TimeSystem, Greybox-Räume, „Die Grauen"/Barks, Cassian + Tag-9-Hinterhalt, Imogen-Abendszenen, Stat-pro-Raum, Wren-Eskorte, Codex) ist bereits erledigt und steht NICHT nochmal hier. Vor der Umsetzung lesen: SPEC.md (§3, §5.1, §6), STORY.md (§3, §5, §6), dragons/SMÀLADH.md, WELT.md. Greybox-First, alles daten-getrieben.

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.