windgeschworen/docs/SPEC.md
danny f4c67ceead Phase 0: Greybox-Fundament
- 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>
2026-07-04 14:56:00 +02:00

121 lines
6.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 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)
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** — 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).