windgeschworen/docs/SPEC.md
danny ce6dbd8408 Begriffs-Übersetzung nach begriffe_uebersetzung.csv (Spieltexte + docs)
- Buchbegriffe durchgängig ersetzt: Wing→Geschwader, Wingleader→
  Geschwaderführer, Squad→Staffel (inkl. Staffelführer/Staffel-Ansehen),
  Battle Brief→Gefechtskunde, Signet→Siegelkraft, Venin→Veneni,
  Sage→Lehrmeister, Wards→Schutzzauber, Wardstone→Obelisken,
  Presentation Day→Tag der Präsentation, Parapet→Viadukt (Spieltexte)
- Betroffen: Dialoge (Ankunft, Cassian, Rhiannon), Barks, Codex,
  Lexicon-Fachseiten, Siegelkraft-Tabelle, Szenen-Labels/Stationen,
  Reveal-Text — Code-Bezeichner (Flags, Node-/Dateinamen) unverändert
- docs/*.md komplett nachgezogen (inkl. Grammatik-Anpassung der Artikel:
  die Siegelkraft/die Staffel); Buchtitel *Fourth Wing* und Kanon-Glossen
  wie „(Wards)"/„(Marked Ones)" bleiben stehen
- docs/.gdignore: stoppt Godots CSV-Import (erzeugte .translation-Reste)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-16 17:10:17 +02:00

15 KiB

SPEC.md — Windgeschworen

Single Source of Truth. Claude Code liest dieses Dokument (plus STORY.md, CHARACTERS.md, WELT.md, ASSETS.md, SIGNETS.md, DRACHEN.md, LESSER_MAGIC.md, ORTE.md, REBELLION_RELIC.md, TYRRISH_REBELLION.md, HAKEN.md, sowie alle Akten in docs/humans/, docs/dragons/ und docs/locations/ — je nach Aufgabe die relevanten Dateien) 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, Siegelkräfte, 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: humans/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).
  • Staffel: Tyrveil ist im selben Geschwader und Staffel wie Violet (Viertes Geschwader) — teilt den Staffel-Alltag mit Violet, Rhiannon, Ridoc, Sawyer und Liam; Staffel Leader ist Dain. Verankert die Freundschaft zu Violet/Liam im Alltag (Formationen, Sparring-Paarungen, Staffel-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 & Staffel → 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 (fixe Bindung an Smàladh; Daumen aus Klinge/Herz + Cassian-Ausgang + Drachenkunde-Wissen färben Siegelkraft-Stärke/Bindungsqualität) → Siegelkraft-Reveal (+ geheimes zweite Siegelkraft durch die Blutlinien-Bindung) → 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. Kanon-Abgleich aller hier genannten und weiterer Buch-Orte (inkl. wo das Spiel bewusst vereinfacht/umbenennt, z. B. „Rotunde" = Kaoris Klassenzimmer statt der architektonischen Buch-Rotunda): ORTE.md.

  • 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.
  • Gefechtskunde-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).
  • Staffel-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 (dragons/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 Siegelkraft-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.
  • Siegelkraft: nach der Bindung eine zufällige einzigartige Kraft aus der Tabelle (Reveal-Moment; Gewichtung nach Kanon-Seltenheit — siehe SIGNETS.md).
  • Zweite Siegelkraft (Tyrveil, fix): Weil Smàladh ihn aus der direkten Blutlinie seines früheren Reiters bindet, entwickelt Tyrveil nach Kanon-Regel (DRACHEN.md) ein zweite Siegelkraft — wie Xaden (dessen Großvater Sgaeyls früherer Reiter war). Es wird geheim gehalten, weil es die verbotene Blutlinien-Bindung beweist; nur Xaden erkennt es und lehrt ihn das Verbergen. Der Wahnsinns-Ausgang der Kanon-Regel greift bei Tyrveil NICHT (bleibt Haken). Details: STORY.md §5 (Klimax), dragons/SMÀLADH.md. Offen: welche konkrete Kraft (Vorschlag: die Siegelkraft seines Vaters).
  • 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 (Gefechtskunde), 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, Gefechtskunde-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 + Siegelkraft-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 Veneni/Wyvern-Arc (nur als Haken angelegt), PS5-Spezialhaptik (adaptive Trigger).