- 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>
123 lines
7.9 KiB
Markdown
123 lines
7.9 KiB
Markdown
# 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).
|