- SPEC §4, WELT §9 + Violet-Eintrag, CHARACTERS: Tyrveil teilt Violets Squad (Fourth Wing, Squad Leader Dain; Kameraden Violet/Rhiannon/Ridoc/Sawyer/Liam) - CHANGEREQUESTS.md: CR 5 zur Umsetzung im Spiel (Ankunft & Squad, Squad-Ansehen) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
201 lines
14 KiB
Markdown
201 lines
14 KiB
Markdown
# SPEC.md — Windgeschworen
|
|
|
|
> Single Source of Truth. Claude Code liest dieses Dokument (plus STORY.md,
|
|
> CHARACTERS.md, TYRVEIL.md, Smàladh.md, Imogen.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).
|
|
- **Squad:** Tyrveil ist im **selben Wing und Squad wie Violet** (Fourth Wing) —
|
|
teilt den Squad-Alltag mit Violet, Rhiannon, Ridoc, Sawyer und Liam; Squad
|
|
Leader ist Dain. Verankert die Freundschaft zu Violet/Liam im Alltag
|
|
(Formationen, Sparring-Paarungen, Squad-Ansehen §6).
|
|
- 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 →
|
|
**10 spielbare Tage** (dichter Akademie-Zyklus: Unterricht / Hof / Cassian-
|
|
Konflikt / Imogens Zimmer; Slots Vormittag/Nachmittag/Abend) → Hinterhalt im
|
|
Materialraum (Tag 9, taktisches Sparring/QTE, Klinge-↔-Herz-Weiche) → Gauntlet
|
|
(Skill-Gate + Story-Wendepunkt, Marens Tod) → Dreschen (Zufalls-Bindung; Daumen
|
|
aus Klinge/Herz + Cassian-Ausgang + Drachenkunde-Wissen) → Signet-Reveal →
|
|
Flugstunden-Teaser (Cliffhanger, Ende v1).
|
|
|
|
Die Story sitzt exakt auf diesem Loop — siehe STORY.md, Abschnitt 5.
|
|
|
|
### 5.1 Greybox-Hub — Raum-Architektur (Primitiven-Layout)
|
|
Alle Räume sind GREYBOX (Boxen, Kapseln, Zylinder, Quads) und über Zonen-Wechsel
|
|
vom **Hof** (zentraler Hub) erreichbar. Licht + Partikel sind billige Atmosphäre,
|
|
kein Blocker. Jeder Unterrichtsraum steigert einen Stat (siehe §6). Diese Layouts
|
|
sind verbindlich schon für die Greybox — sie definieren Blockvolumen, Kollision
|
|
und Kamera-Framing.
|
|
|
|
- **Sparringshalle (Prof. Emetterio) — steigert Kraft & Schnelligkeit.**
|
|
Riesige, kalte Halle: hoher Box-Quader als Raum. Im Zentrum eine massive,
|
|
kreisrunde **Kampfmatte** = flacher, breiter **Zylinder** (Radius ~6 m, Höhe
|
|
0,1 m), leicht abgesetzte Farbe. Um die Matte ein Ring stehender Kapsel-NPCs
|
|
(Kadetten als Publikum). An den Längswänden **Waffenständer** = schmale Box-
|
|
Regale mit Kapsel/Zylinder-Platzhaltern für Trainingsschwerter und Dolche.
|
|
Hohe, schmale Fensterschlitze werfen Lichtkegel; **Staubpartikel** (GPUParticles)
|
|
in den Kegeln. Kamera schwenkt beim Sparring cineastisch näher an die Matte.
|
|
- **Battle-Brief-Raum / Aula (Prof. Devera) — steigert Verstand.**
|
|
Steil ansteigender, amphitheaterartiger Hörsaal: gestufte **Rampe aus Box-
|
|
Reihen** (steinerne Sitzbänke), die konzentrisch nach unten fallen. Ganz unten
|
|
im Zentrum ein gewaltiger, flacher **Taktiktisch** = breite niedrige Box; darüber
|
|
ein **Karten-Projektions-Platzhalter** (halbtransparentes Quad/Flachbox, später
|
|
magische Karte). Kühles, gerichtetes Licht, harte Schatten. Atmosphäre: extrem
|
|
diszipliniert, angespannt, still.
|
|
- **Drachen-Rotunde (Prof. Kaori) — steigert Verstand & Drachenkunde-Wissen.**
|
|
Kreisrunder, kuppelförmiger Raum: **Zylinder-Wand + Halbkugel-Dach**. Die
|
|
gekrümmten Wände sind gepflastert mit **Schiefertafel-Quads** (Platzhalter für
|
|
Kohlezeichnungen: Drachen-Silhouetten, Schwanztypen Schwert/Skorpion, Anatomie).
|
|
Zentrale niedrige Box als Lesepult. Warmes, gedämpftes Licht; Staub. Das hier
|
|
erlernte Drachenkunde-Wissen zählt als Daumen beim Dreschen (§6).
|
|
- **Geschichtsklasse (Prof. Markham) — Lore/RSC (leichter Verstand).**
|
|
Bedrückender, staubiger Raum im Lehrtrakt: enge Box, vollgestellt mit schweren
|
|
**Holztisch-Boxen** und wandhohen **Regal-Boxen** voller Chronik-Quads. Kaum
|
|
Tageslicht; dominiert von **Kerzenschein** (mehrere warme Punktlichter). Hier
|
|
hört Tyrveil die verlogene Version seiner Vatergeschichte — der Raum soll eng
|
|
und feindselig wirken.
|
|
- **Imogens Einzelzimmer (Wohntrakt 2. Jahrgang) — sicherer Rückzugsort.**
|
|
Kleiner privater Raum (kleine Box), Gegenpol zu den Massenschlafsälen: ein
|
|
**Bett** (Box), ein kleiner **Holzschreibtisch** (Box) mit Stuhl, ein **Fenster**
|
|
(Quad) mit Blick auf den nächtlichen Hof (Skybox/Backdrop). Gedämpftes, warmes
|
|
Licht; ein paar persönliche Gegenstände (kleine Box-Props). Anker aller
|
|
Abend-/Nacht-Szenen; hier greift das Mature-Gate. Ab einem Story-Flag beendet
|
|
dieses Zimmer den Tag statt des Schlafsaals.
|
|
- **Der Hof (Trainingsplatz) + Materialraum — Hub & Ambush-Arena.**
|
|
Weitläufiger, windiger Steinplatz (große Boden-Box), umgeben von den massiven
|
|
**Zitadellen-Mauern** (hohe Box-Wände). Zentraler Knoten: von hier gehen alle
|
|
Zonen ab; hier laufen „Die Grauen" (§6) und Cassians Konfrontationen. In einer
|
|
Ecke der hölzerne **Materialraum** = enge, düstere Box (Lager für Übungswaffen,
|
|
Schilde, Karten als gestapelte Box-Props), mit Regalen, die **tote Winkel** und
|
|
Sichtblocker schaffen — bewusst als Hinterhalt-Arena gebaut (Tag 9). Wind-SFX,
|
|
wehende Partikel auf dem Hof; Enge und wenig Licht im Materialraum.
|
|
|
|
## 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 (bzw. ab einem
|
|
Story-Flag Imogens Zimmer) beendet den Tag. **v1 umfasst 10 solcher Tage** mit
|
|
festem, skript-getriebenem Fahrplan (siehe STORY.md §5) — jeder Tag zieht die
|
|
Daumenschrauben enger.
|
|
- **Statisten „Die Grauen" + Bark-System**: namenlose Kadetten-NPCs (graue
|
|
Kapsel-/Pilz-Primitiven) bevölkern Hof und Gänge — nicht anklickbar. Beim
|
|
Vorbeilaufen (Trigger-Radius + Cooldown) feuern sie zufällige **Überkopf-
|
|
Textboxen (Barks)** aus einem gewichteten Daten-Pool (`data/barks/`) und
|
|
transportieren die paranoide Basgiath-Atmosphäre. Ab Tag 4 gibt es eine
|
|
skript-getriggerte „Schergen"-Variante (dieselben Modelle), die Wren gezielt
|
|
anrempelt.
|
|
- **Dialog-System**: verzweigte Bäume, daten-getrieben, Entscheidungen mit
|
|
Klinge/Herz-Tags.
|
|
- **Drachen-Bindung (Dreschen)**:
|
|
- **Tyrveils Bindung ist FIX: immer Smàladh**, ein riesiger schwarzer
|
|
Skorpionschwanz — der totgeglaubte Drache seines Vaters (Smàladh.md; STORY.md
|
|
§5). Keine Zufalls-Art für den Protagonisten.
|
|
- Die Drachen-Arten-Tabelle bleibt als Welt-/Lore-Flavor (Farben Rot/Blau/Grün/
|
|
Braun/Orange + Schwanztypen Schwert/Dolch/Keule/Morgenstern/Skorpion; selten
|
|
Schwarz; **Federschwanz = Kanon-Hintergrund über Violets Andarna, NICHT
|
|
Tyrveils Ausgang**).
|
|
- Die Daumen (Klinge/Herz + Spielweise + Story-Flags: Wren-/Maren-Bindung,
|
|
Cassian-Ausgang, Drachenkunde-Wissen) färben **Signet-Stärke,
|
|
Bindungsqualität und die Dramaturgie des Bindungs-Moments** — NICHT die
|
|
Drachen-Art.
|
|
- Bei Permadeath ON bleibt der Bindungs-Moment dramaturgisch tödlich möglich.
|
|
- **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.), **Cassian Vane (orig., Antagonist)**, **Smàladh (orig., Drache —
|
|
Tyrveils fixe Bindung)** + Professoren: **Emetterio**
|
|
(Sparring/Kampf), **Devera** (Battle Brief), **Kaori** (Drachenkunde/Rotunde),
|
|
**Markham** (Geschichte/RSC), + Landnavigation. Statisten: **„Die Grauen"**
|
|
(namenlose Kadetten-Füllung mit Bark-Lines). Stimmen/Details: CHARACTERS.md.
|
|
|
|
## 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)
|
|
- `attack` — Linksklick / R2 (Schlagen im Sparring)
|
|
- `block` — Rechtsklick / ▢(PS5) Ⓧ(Xbox) (button_index 2, Blocken im Sparring)
|
|
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 (10-Tage-Zyklus), Sparring, Cassian & Marens Wendepunkt: Ausbau des Tageszyklus auf **10 Tage** mit festem, skript-getriebenem Fahrplan (STORY §5). Bau der spezialisierten Greybox-Räume (SPEC §5.1): Sparringshalle, Battle-Brief-Aula, Drachen-Rotunde, Geschichtsklasse, Imogens Zimmer, Hof + Materialraum. Stat-basiertes, taktisches **Sparring** (Werte-Checks Kraft/Schnelligkeit/Verstand + taktische Klinge/Herz-Entscheidungen) und Unterrichtsstunden zur Stat-Steigerung. **„Die Grauen" + Bark-System.** Neuer Antagonist **Cassian Vane** mit Dialogbäumen und über die Tage eskalierendem psychologischem Druck; **Hinterhalt im Materialraum (Tag 9)** mit tödlichem QTE (Kopplung an Permadeath) und zwei Ausgängen (Herz/Klinge) als massivem Dreschen-Daumen. Imogen-Abendszenen (Mature-Gate). Fraktions-Standing der Gezeichneten. Der **Gauntlet**-Lauf als manipuliertes Skill-Gate. Story-Klimax 1: Marens fixer Tod, Reveal von Wahrheit 1 & 2. (Jack Barlowe bleibt als kanonische Hintergrund-Bedrohung / Bark-Flavor, nicht als ausgespielter Kampf.)
|
|
- **Phase 5** — Dreschen + Bindungs-RNG + Signet-Reveal + Wahrheit 3 + Teaser. Erweiterung: Der Ausgang des Cassian-Konflikts (Tag 9) aus Phase 4 UND das erlernte Drachenkunde-Wissen (Rotunde) fließen als zusätzliche 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).
|