- Input-Map: alle Actions aus SPEC 9 (Tastatur + Xbox/PS5, physische Keycodes, Deadzone 0.2) - 11 Autoload-Skelette (SPEC 8) mit Doku-Bloecken, ohne Logik - Greybox-Testszene test_ground.tscn: Boden, Hindernisse, Spieler-Kapsel, Third-Person-Kamera (WoW-Zoom via SpringArm3D), WorldEnvironment - Debug-Overlay: FPS, aktives Eingabegeraet, Position, Kamera-Zoom - test_ground.tscn als Main Scene gesetzt Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
6.2 KiB
SPEC.md — Windgeschworen
Single Source of Truth. Claude Code liest dieses Dokument (plus STORY.md, CHARACTERS.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: CHARACTERS.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 Sticklook_x/look_y— Maus + rechter Stickcamera_zoom_in/camera_zoom_out— Mausrad + Schultertasteninteract— 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) UI nutztconfirm/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 — Tageszyklus + Stats + Save/Load + Greybox-Hub (Reiterquadrant, Schlafsaal, Klassenraum).
- Phase 2 — Dialog-System + erste NPCs (Violet, Imogen, Rhiannon, Wren).
- Phase 3 — Viadukt-Set-Piece + Charakter-Anlage + Klinge/Herz-Achse.
- Phase 4 — Unterricht, Gauntlet, Beziehungs-/Fraktions-Logik, Maren-Wendepunkt (Wahrheit 1 & 2).
- Phase 5 — Dreschen + Bindungs-RNG + Signet-Reveal + Wahrheit 3 + Teaser.
- Phase 6 — Codex, Mature-Gate, Permadeath-Toggle, Button-Prompts, Polish.
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).