windgeschworen/docs/SPEC.md
danny 1a2c1be65d CR-Paket: Rad flach + tastenlos, Kugel-Griff gefixt, Seil-Prioritaet, dynamische Button-Prompts
- spinning_wheel: flache Dreh-Scheibe im Laufweg statt aufrechter
  Trommel; Interaktion rein ueber Hitbox (drauflaufen, kein Tastendruck):
  Drehung reisst tangential mit (A/D gegenhalten), fehlendes Tortenstueck
  laesst am Boden durchfallen (im Sprung uebersprungen), Nabe sicher,
  Ausstiegs-Zone meldet den Uebergang
- buoy_ball: Greifen von body_entered-Events auf Abstands-Polling
  umgestellt (Events feuerten nicht, wenn der Spieler schon im Bereich
  stand -> Kugeln waren nicht greifbar); grab_radius-Export,
  Wiedergreif-Sperre 1,5 s nach jedem Loslassen gegen sofortiges
  Wieder-Einsammeln durch dieselbe Kugel
- safety_rope_field: Fang nur bei echtem Sturz (Fall unter -7 m/s UND
  Sturzkorridor oder >3 m unter letzter Standhoehe) - kurze Huepfer
  loesen kein Greif-Fenster mehr aus; keine Eingabe-Kollision Rad/Seil
- InputPrompts-Autoload implementiert (war Skelett): erkennt Tastatur
  vs. Xbox/PlayStation am letzten Input-Event bzw. Joypad-Namen,
  liefert Action-Labels ([E]/[Leertaste] vs. [A]/[LB] vs. [Kreuz]/[L1]),
  device_changed fuer Live-Umschaltung; Welt-Prompts (Label3D) an
  Kugeln/Schienen/Kamin, Bildschirm-Prompts nutzen dynamische Labels
- gravel_curve.gd nachcommittet (fehlte in V.0.6.1, wird von der
  Gauntlet-Szene referenziert)
- Verifikation: Headless-Sonde komplett gruen (70+ Checks inkl. neuer
  Rad-/Kugel-/Seil-/Prompt-Tests), Boot-Check aller 6 Szenen fehlerfrei
- v1-Ausbau (10-Tage-Zyklus) bleibt als Phasen-Programm in
  CHANGEREQUESTS.md, Fix-CRs nach CHANGEREQUESTS_DONE.md uebertragen

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

13 KiB

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 → 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):
    • 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.), Cassian Vane (orig., Antagonist) + 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).