windgeschworen/docs/SPEC.md
danny d1e07cc06f CR: X-Taste bricht Gespraeche ab, zufaellige Abschieds-Zeilen pro Char
- Neue Input-Action dialogue_abort (X) zusaetzlich zu cancel; eigene
  Action, damit X im normalen Spiel nicht die Maus freigibt; SPEC 9
  ergaenzt
- abort_lines-Arrays in allen vier Dialog-Dateien (je drei Varianten in
  Tyrveils Stimme: Imogen liebevoller, Violet geschwisterlich, Rhiannon
  freundlich, Wren beschuetzend), zufaellige Auswahl beim Abbruch
- Headless verifiziert: X bricht bei offener Auswahl und waehrend Zeilen
  ab, Zeile stammt aus dem richtigen Pool, Effekt-/Flag-Semantik intakt

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-05 11:50:11 +02:00

123 lines
7.9 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, 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)
- `dialogue_abort` — X (bricht laufende Gespräche ab; `cancel` bricht ebenfalls ab)
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).