# SPEC.md — Windgeschworen > Single Source of Truth. Claude Code liest dieses Dokument (plus STORY.md, > CHARACTERS.md, TYRVEIL.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 → 3–4 spielbare Tage (Unterricht / Schlafsaal / NPCs) → Gauntlet (Skill-Gate + Story-Wendepunkt) → Dreschen (Zufalls-Bindung) → Signet-Reveal → Flugstunden-Teaser (Cliffhanger, Ende v1). Die Story sitzt exakt auf diesem Loop — siehe STORY.md, Abschnitt 5. ## 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 beendet den Tag. - **Dialog-System**: verzweigte Bäume, daten-getrieben, Entscheidungen mit Klinge/Herz-Tags. - **Drachen-Bindung (Dreschen)**: - Gewichtete Zufalls-Tabelle für Art: Farbe (Rot/Blau/Grün/Braun/Orange) + Schwanztyp (Schwert/Dolch/Keule/Morgenstern/Skorpion). - Selten: Schwarz (~5%), Federschwanz (~4%). - Bindungs-Erfolg = Basis-Zufall + LEICHTER Kompatibilitäts-Daumen aus Klinge/Herz + Spielweise + Story-Flags (Wren/Maren-Bindung erhöht Chance auf Federschwanz/Vater-verbundenen Drachen — siehe STORY.md 5, Klimax). - Manche Drachen lehnen ab. Bei Permadeath ON kann Scheitern = Tod. - **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.) + Lehrer (Kampf, Landnavigation, Geschichte/RSC, Drachenkunde). ## 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) 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, Sparring & Marens Wendepunkt: Implementierung eines stat-basierten, taktischen Sparring-Systems im Reiterquadranten (Werte-Checks für Kraft/Schnelligkeit/Verstand + taktische Klinge/Herz-Entscheidungen). Integration von Jack-Barlowe-Hinterhalten mit tödlichen Quick-Time-Events (QTE) via Input-Actions (Kopplung an Permadeath). Unterrichtsstunden zur Stat-Steigerung, Fraktions-Standing der Gezeichneten. Der Gauntlet-Lauf als manipuliertes Skill-Gate. Story-Klimax 1: Marens fixer Tod, Reveal von Wahrheit 1 & 2. - **Phase 5** — Dreschen + Bindungs-RNG + Signet-Reveal + Wahrheit 3 + Teaser. Erweiterung: Der Ausgang des Jack-Barlowe-Konflikts aus Phase 4 fließt als zusätzlicher 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).