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>
This commit is contained in:
danny 2026-07-04 14:56:00 +02:00
commit f4c67ceead
40 changed files with 1064 additions and 0 deletions

121
docs/SPEC.md Normal file
View file

@ -0,0 +1,121 @@
# 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).