# SPEC.md — Windgeschworen > Single Source of Truth. Claude Code liest dieses Dokument (plus STORY.md, > CHARACTERS.md, TYRVEIL.md, Smàladh.md, Imogen.md, WELT.md, ASSETS.md) VOR jeder > Aufgabe. Bei Konflikt gewinnt die SPEC. ## 1. Vision Third-Person-RPG im ersten Ausbildungsjahr an einer Drachenreiter-Akademie. Spieler ist Tyrveil, ein Gezeichneter. Fokus: Story, Beziehungen, Tageszyklus, Drachen-Bindung. Kein Action-MMO — ein narratives RPG in einer 3D-Welt. Privates Fan-Projekt (siehe Rechtehinweis in README.md). ## 2. Tech & Constraints - Godot 4.3+ (stable), GDScript. Kein C#. - Third-Person-Kamera, weit rausgezoomt (WoW-Style). Cineastisches Reinschwenken bei Set-Pieces (Viadukt, Dreschen). - Look: stilisiert / low-poly. **GREYBOX-FIRST**: alles zuerst mit Primitiven (Kapseln, Boxen). Das Spiel muss OHNE echte Assets vollständig spielbar und testbar sein. Echte Modelle werden später eingetauscht. - Ziel-Build: Windows-.exe (Godot Native Export). - **Daten-getrieben**: Dialoge, Drachen, Signets, NPCs, Story-Beats liegen in .tres/.json unter data/, NICHT hartcodiert. - Input: Tastatur + **Xbox- und PS5-Controller** (Godot-native, SDL). Alles über Input-Actions. UI **fokus-navigierbar** (D-Pad/Stick). Dynamische Button-Prompts (Xbox-Glyphen vs. PS5-Glyphen je erkanntem Gerät). ## 3. Namens-Konvention (projekteigen — NICHT Cutvert/WP/Shopware) - Dateien, Funktionen, Variablen, Signals: `snake_case` - Klassen / Node-Namen / Autoloads: `PascalCase` - Konstanten: `UPPER_SNAKE_CASE` - Booleans: `is_`, `has_`, `can_` Präfix - Kein globales Prefix an Dateien/Klassen. - **Keine Inline-Kommentare.** Erlaubt: `##`-Doku-Blöcke ÜBER Funktionen und Klassen (Zweck + Parameter erklären). ## 4. Protagonist & Setup (Details: TYRVEIL.md; Welt/Kanon: WELT.md) - Tyrveil: Gezeichneter, kampfgehärteter Build (solide Kraft/Schnelligkeit, Verstand wächst übers Spiel). Kern-Dualität **Klinge ↔ Herz**. - Mit Imogen liiert (bestehende Beziehung → "Beziehung unter Druck"). - Läuft mit Violet (Verbündete/Freundin, NICHT Protagonistin). - Xaden = Anführer/Verbündeter der Gezeichneten, kein Love Interest. - Fraktion "Gezeichnete": beobachtet, kriegt gefährliche Aufträge, hütet Geheimnisse → eigener Story-Motor. ## 5. v1 Core Loop (Vertical Slice) Charakter-Anlage → Viadukt (Set-Piece, Tod möglich) → Ankunft & Squad → **10 spielbare Tage** (dichter Akademie-Zyklus: Unterricht / Hof / Cassian- Konflikt / Imogens Zimmer; Slots Vormittag/Nachmittag/Abend) → Hinterhalt im Materialraum (Tag 9, taktisches Sparring/QTE, Klinge-↔-Herz-Weiche) → Gauntlet (Skill-Gate + Story-Wendepunkt, Marens Tod) → Dreschen (Zufalls-Bindung; Daumen aus Klinge/Herz + Cassian-Ausgang + Drachenkunde-Wissen) → Signet-Reveal → Flugstunden-Teaser (Cliffhanger, Ende v1). Die Story sitzt exakt auf diesem Loop — siehe STORY.md, Abschnitt 5. ### 5.1 Greybox-Hub — Raum-Architektur (Primitiven-Layout) Alle Räume sind GREYBOX (Boxen, Kapseln, Zylinder, Quads) und über Zonen-Wechsel vom **Hof** (zentraler Hub) erreichbar. Licht + Partikel sind billige Atmosphäre, kein Blocker. Jeder Unterrichtsraum steigert einen Stat (siehe §6). Diese Layouts sind verbindlich schon für die Greybox — sie definieren Blockvolumen, Kollision und Kamera-Framing. - **Sparringshalle (Prof. Emetterio) — steigert Kraft & Schnelligkeit.** Riesige, kalte Halle: hoher Box-Quader als Raum. Im Zentrum eine massive, kreisrunde **Kampfmatte** = flacher, breiter **Zylinder** (Radius ~6 m, Höhe 0,1 m), leicht abgesetzte Farbe. Um die Matte ein Ring stehender Kapsel-NPCs (Kadetten als Publikum). An den Längswänden **Waffenständer** = schmale Box- Regale mit Kapsel/Zylinder-Platzhaltern für Trainingsschwerter und Dolche. Hohe, schmale Fensterschlitze werfen Lichtkegel; **Staubpartikel** (GPUParticles) in den Kegeln. Kamera schwenkt beim Sparring cineastisch näher an die Matte. - **Battle-Brief-Raum / Aula (Prof. Devera) — steigert Verstand.** Steil ansteigender, amphitheaterartiger Hörsaal: gestufte **Rampe aus Box- Reihen** (steinerne Sitzbänke), die konzentrisch nach unten fallen. Ganz unten im Zentrum ein gewaltiger, flacher **Taktiktisch** = breite niedrige Box; darüber ein **Karten-Projektions-Platzhalter** (halbtransparentes Quad/Flachbox, später magische Karte). Kühles, gerichtetes Licht, harte Schatten. Atmosphäre: extrem diszipliniert, angespannt, still. - **Drachen-Rotunde (Prof. Kaori) — steigert Verstand & Drachenkunde-Wissen.** Kreisrunder, kuppelförmiger Raum: **Zylinder-Wand + Halbkugel-Dach**. Die gekrümmten Wände sind gepflastert mit **Schiefertafel-Quads** (Platzhalter für Kohlezeichnungen: Drachen-Silhouetten, Schwanztypen Schwert/Skorpion, Anatomie). Zentrale niedrige Box als Lesepult. Warmes, gedämpftes Licht; Staub. Das hier erlernte Drachenkunde-Wissen zählt als Daumen beim Dreschen (§6). - **Geschichtsklasse (Prof. Markham) — Lore/RSC (leichter Verstand).** Bedrückender, staubiger Raum im Lehrtrakt: enge Box, vollgestellt mit schweren **Holztisch-Boxen** und wandhohen **Regal-Boxen** voller Chronik-Quads. Kaum Tageslicht; dominiert von **Kerzenschein** (mehrere warme Punktlichter). Hier hört Tyrveil die verlogene Version seiner Vatergeschichte — der Raum soll eng und feindselig wirken. - **Imogens Einzelzimmer (Wohntrakt 2. Jahrgang) — sicherer Rückzugsort.** Kleiner privater Raum (kleine Box), Gegenpol zu den Massenschlafsälen: ein **Bett** (Box), ein kleiner **Holzschreibtisch** (Box) mit Stuhl, ein **Fenster** (Quad) mit Blick auf den nächtlichen Hof (Skybox/Backdrop). Gedämpftes, warmes Licht; ein paar persönliche Gegenstände (kleine Box-Props). Anker aller Abend-/Nacht-Szenen; hier greift das Mature-Gate. Ab einem Story-Flag beendet dieses Zimmer den Tag statt des Schlafsaals. - **Der Hof (Trainingsplatz) + Materialraum — Hub & Ambush-Arena.** Weitläufiger, windiger Steinplatz (große Boden-Box), umgeben von den massiven **Zitadellen-Mauern** (hohe Box-Wände). Zentraler Knoten: von hier gehen alle Zonen ab; hier laufen „Die Grauen" (§6) und Cassians Konfrontationen. In einer Ecke der hölzerne **Materialraum** = enge, düstere Box (Lager für Übungswaffen, Schilde, Karten als gestapelte Box-Props), mit Regalen, die **tote Winkel** und Sichtblocker schaffen — bewusst als Hinterhalt-Arena gebaut (Tag 9). Wind-SFX, wehende Partikel auf dem Hof; Enge und wenig Licht im Materialraum. ## 6. Systeme - **Stats**: Kraft, Schnelligkeit, Verstand (steigen über Aktivitäten). - **Klinge-↔-Herz-Achse**: Ton-Wert (-100 Klinge .. +100 Herz), gesetzt durch Dialog-Entscheidungen. Färbt Reaktionen, Fraktion, Bindungs-Daumen. - **Beziehungswerte** pro NPC (-100..+100). - **Squad-Ansehen** + **Fraktions-Standing Gezeichnete**. - **Menschlichkeits-Messwert** (verdeckt, in v1 nur gesammelt). - **Tageszyklus**: Slots Vormittag/Nachmittag/Abend; Schlafsaal (bzw. ab einem Story-Flag Imogens Zimmer) beendet den Tag. **v1 umfasst 10 solcher Tage** mit festem, skript-getriebenem Fahrplan (siehe STORY.md §5) — jeder Tag zieht die Daumenschrauben enger. - **Statisten „Die Grauen" + Bark-System**: namenlose Kadetten-NPCs (graue Kapsel-/Pilz-Primitiven) bevölkern Hof und Gänge — nicht anklickbar. Beim Vorbeilaufen (Trigger-Radius + Cooldown) feuern sie zufällige **Überkopf- Textboxen (Barks)** aus einem gewichteten Daten-Pool (`data/barks/`) und transportieren die paranoide Basgiath-Atmosphäre. Ab Tag 4 gibt es eine skript-getriggerte „Schergen"-Variante (dieselben Modelle), die Wren gezielt anrempelt. - **Dialog-System**: verzweigte Bäume, daten-getrieben, Entscheidungen mit Klinge/Herz-Tags. - **Drachen-Bindung (Dreschen)**: - **Tyrveils Bindung ist FIX: immer Smàladh**, ein riesiger schwarzer Skorpionschwanz — der totgeglaubte Drache seines Vaters (Smàladh.md; STORY.md §5). Keine Zufalls-Art für den Protagonisten. - Die Drachen-Arten-Tabelle bleibt als Welt-/Lore-Flavor (Farben Rot/Blau/Grün/ Braun/Orange + Schwanztypen Schwert/Dolch/Keule/Morgenstern/Skorpion; selten Schwarz; **Federschwanz = Kanon-Hintergrund über Violets Andarna, NICHT Tyrveils Ausgang**). - Die Daumen (Klinge/Herz + Spielweise + Story-Flags: Wren-/Maren-Bindung, Cassian-Ausgang, Drachenkunde-Wissen) färben **Signet-Stärke, Bindungsqualität und die Dramaturgie des Bindungs-Moments** — NICHT die Drachen-Art. - Bei Permadeath ON bleibt der Bindungs-Moment dramaturgisch tödlich möglich. - **Signet**: nach Bindung zufällige einzigartige Kraft aus Tabelle (Reveal-Moment). - **Permadeath**: Toggle, Default AN (Ironman). Aus = Story-Modus mit Checkpoints. - **Save/Load**. - **Codex/Journal**: Drachen, Charaktere, Lore (füllt sich beim Entdecken). - **Mature-Content**: 18+-Gate beim 1. Start + Content-Warnung + Options-Toggle (Default AUS). Romantik-Szenen zweigleisig: Fade-to-Black (default) / explizit (nur bei Toggle; explizite Textvarianten in gegateten Datendateien, vom Nutzer gepflegt, NICHT von Claude Code generiert). ## 7. NPCs (v1) Violet, Xaden, Rhiannon, Dain, Sawyer, Ridoc, Liam, Imogen, Wren (orig.), Maren (orig.), **Cassian Vane (orig., Antagonist)**, **Smàladh (orig., Drache — Tyrveils fixe Bindung)** + Professoren: **Emetterio** (Sparring/Kampf), **Devera** (Battle Brief), **Kaori** (Drachenkunde/Rotunde), **Markham** (Geschichte/RSC), + Landnavigation. Statisten: **„Die Grauen"** (namenlose Kadetten-Füllung mit Bark-Lines). Stimmen/Details: CHARACTERS.md. ## 8. Architektur (Autoloads / Singletons) `GameState`, `SaveSystem`, `DialogueSystem`, `TimeSystem`, `RelationshipSystem`, `FactionSystem`, `DragonBondSystem`, `SignetSystem`, `StorySystem`, `InputPrompts`, `MatureContentGate`. Autoloads werden in Phase 0 als leere, dokumentierte Skelette angelegt und schrittweise gefüllt. ## 9. Input-Actions (in Phase 0 in project.godot verdrahten) Tastatur + Xbox/PS5. Deadzone 0.2 für Sticks/Trigger. - `move_forward` / `move_back` / `move_left` / `move_right` — WASD + linker Stick - `look_x` / `look_y` — Maus + rechter Stick - `camera_zoom_in` / `camera_zoom_out` — Mausrad + Schultertasten - `interact` — E / Ⓐ(Xbox) ✕(PS5) (button_index 0) - `confirm` — Enter / Ⓐ ✕ (0) - `cancel` — Esc / Ⓑ ◯ (1) - `menu` — Tab / Start (6) - `journal` — J / Ⓨ △ (3) - `sprint` — Shift / linker Stick-Klick (7) - `slide` — C / Linker Trigger (L2/LT) (Zum Rutschen auf dem Boden) - `jump` — Leertaste / Ⓐ / ✕ (Wird beim Laufen gegen Wände automatisch für das Klettern/Hochziehen getriggert) - `dialogue_abort` — X (bricht laufende Gespräche ab; `cancel` bricht ebenfalls ab) - `attack` — Linksklick / R2 (Schlagen im Sparring) - `block` — Rechtsklick / ▢(PS5) Ⓧ(Xbox) (button_index 2, Blocken im Sparring) UI nutzt `confirm`/`cancel`/`menu` + Focus-Navigation. ## 10. Phasen-Roadmap - **Phase 0** — Setup, .gitignore, Input-Map, Autoload-Skelette, Greybox- Testszene mit Third-Person-Controller (WoW-Zoom), Controller + Tastatur laufen, Debug-Overlay. Runnable. - **Phase 1** — Fundament, Zeit & Werte: Tageszyklus (Vormittag/Nachmittag/Abend, Schlafsaal beendet Tag), Stats (Kraft/Schnelligkeit/Verstand). NEU: Klinge-↔-Herz-Achse und NPC-Beziehungsdaten werden als leere Datenstrukturen/Variablen im GameState angelegt. Save/Load-System für alle diese Werte. Minimalistisches Hauptmenü (Start, Fortsetzen, Beenden). Movement-Upgrade: Erweiterung des Phase-0-Controllers um eine Rutsch-Mechanik (Slide via `slide`) und ein einfaches Klettersystem (automatisches Hochziehen an Kanten bei Wand-Kollision im Sprung). Greybox-Hub (Reiterquadrant, Schlafsaal, Klassenraum aus Primitiven) inklusive Zonen-Wechsel. Einfaches UI-Debug-Overlay zur Werte-Überprüfung. - **Phase 2** — Dialog-System + erste NPCs (Violet, Imogen, Rhiannon, Wren). Entscheidungen verändern aktiv die Klinge-↔-Herz-Achse und die NPC-Beziehungswerte. - **Phase 3** — Viadukt-Set-Piece + Charakter-Anlage. Das eigentliche Action-/Geschicklichkeits-Segment auf dem Viadukt im Greybox-Stil (Rettung von Wren, Beeinflussung durch Klinge/Herz-Wahl, Permadeath-Option). - **Phase 4** — Akademie-Alltag (10-Tage-Zyklus), Sparring, Cassian & Marens Wendepunkt: Ausbau des Tageszyklus auf **10 Tage** mit festem, skript-getriebenem Fahrplan (STORY §5). Bau der spezialisierten Greybox-Räume (SPEC §5.1): Sparringshalle, Battle-Brief-Aula, Drachen-Rotunde, Geschichtsklasse, Imogens Zimmer, Hof + Materialraum. Stat-basiertes, taktisches **Sparring** (Werte-Checks Kraft/Schnelligkeit/Verstand + taktische Klinge/Herz-Entscheidungen) und Unterrichtsstunden zur Stat-Steigerung. **„Die Grauen" + Bark-System.** Neuer Antagonist **Cassian Vane** mit Dialogbäumen und über die Tage eskalierendem psychologischem Druck; **Hinterhalt im Materialraum (Tag 9)** mit tödlichem QTE (Kopplung an Permadeath) und zwei Ausgängen (Herz/Klinge) als massivem Dreschen-Daumen. Imogen-Abendszenen (Mature-Gate). Fraktions-Standing der Gezeichneten. Der **Gauntlet**-Lauf als manipuliertes Skill-Gate. Story-Klimax 1: Marens fixer Tod, Reveal von Wahrheit 1 & 2. (Jack Barlowe bleibt als kanonische Hintergrund-Bedrohung / Bark-Flavor, nicht als ausgespielter Kampf.) - **Phase 5** — Dreschen + Bindungs-RNG + Signet-Reveal + Wahrheit 3 + Teaser. Erweiterung: Der Ausgang des Cassian-Konflikts (Tag 9) aus Phase 4 UND das erlernte Drachenkunde-Wissen (Rotunde) fließen als zusätzliche Daumen auf der Waage in die Drachen-Kompatibilität ein. - **Phase 6** — Codex, Mature-Gate, Permadeath-Toggle, Button-Prompts, Polish. Austausch der Greybox-Primitive gegen die CC0-Low-Poly-Assets und Texturen. ## 11. NICHT in v1 (Out of Scope) Flug-Gameplay, offene Welt, echte 3D-Assets, Multiplayer, spätere Jahre, ausgespielter Venin/Wyvern-Arc (nur als Haken angelegt), PS5-Spezialhaptik (adaptive Trigger).