windgeschworen/docs/SPEC.md
danny 0f4ab3d3eb CR: BG3-Chatbox fuer Dialoge + Doc-Updates (TYRVEIL.md, WELT.md)
- dialogue_choices zu dialogue_box umgebaut: Panel am unteren Bildrand
  zeigt jede Dialog-Zeile mit Sprechernamen lesbar an, Antwortauswahl
  integriert; Sprechblasen bleiben als Ambiente (CHANGEREQUESTS_DONE.md)
- DialogueSystem spiegelt jede Zeile in die Box, Anzeigenamen aus neuer
  speakers-Map der Dialog-Dateien (Fallback: grossgeschriebene ID)
- Einmal-Effekt-Grundlage: GameState.completed_dialogues (gespeichert,
  Save/Load-fest), DialogueSystem wendet Options-Effekte nur beim ersten
  Durchlauf an
- Doc-Updates des Users eingecheckt: TYRVEIL.md (Protagonisten-Akte),
  WELT.md (Buch-Kanon), ueberarbeitete STORY/CHARACTERS/SPEC,
  CHANGEREQUESTS-Workflow

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

7.8 KiB
Raw Blame History

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) 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).