commit f4c67ceead4d84ac63a760a072d5430c5abd0465 Author: danny Date: Sat Jul 4 14:56:00 2026 +0200 Phase 0: Greybox-Fundament - Input-Map: alle Actions aus SPEC 9 (Tastatur + Xbox/PS5, physische Keycodes, Deadzone 0.2) - 11 Autoload-Skelette (SPEC 8) mit Doku-Bloecken, ohne Logik - Greybox-Testszene test_ground.tscn: Boden, Hindernisse, Spieler-Kapsel, Third-Person-Kamera (WoW-Zoom via SpringArm3D), WorldEnvironment - Debug-Overlay: FPS, aktives Eingabegeraet, Position, Kamera-Zoom - test_ground.tscn als Main Scene gesetzt Co-Authored-By: Claude Fable 5 diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..8404e27 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,7 @@ +* text=auto eol=lf +*.png binary +*.jpg binary +*.glb binary +*.fbx binary +*.ogg binary +*.wav binary diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..68b38fd --- /dev/null +++ b/.gitignore @@ -0,0 +1,17 @@ +# Godot 4+ +.godot/ +/android/ +/builds/ +export_presets.cfg + +# Blender / Assets +*.blend1 +*.blend2 + +# OS +.DS_Store +Thumbs.db +desktop.ini + +# Editor +*.tmp diff --git a/README.md b/README.md new file mode 100644 index 0000000..2567be2 --- /dev/null +++ b/README.md @@ -0,0 +1,27 @@ +# Windgeschworen (Arbeitstitel) + +Privates Third-Person-RPG in Godot 4. Erstes Ausbildungsjahr an einer +Drachenreiter-Akademie. Protagonist: Tyrveil, ein Gezeichneter. + +## Für Menschen +Reihenfolge zum Lesen: +1. `docs/SPEC.md` — was gebaut wird, wie, Konventionen, Phasen. +2. `docs/STORY.md` — die Handlung (Kanon, wird nicht überschrieben). +3. `docs/CHARACTERS.md` — Stimmen & Beziehungen. +4. `docs/ASSETS.md` — kostenlose Bezugsquellen (später, Greybox-first). + +## Für Claude Code +Vor JEDER Aufgabe zuerst `docs/SPEC.md`, `docs/STORY.md`, `docs/CHARACTERS.md` +lesen. Diese Docs sind die Source of Truth. Handlung nicht über STORY.md hinaus +erfinden. Prompts liegen in `prompts/` (mit Phase 0 anfangen). + +## Setup +- Godot 4.3+ (stable), GDScript. +- Projekt in Godot öffnen (`project.godot`). Autoloads & Input-Map legt + Phase 0 an. +- Greybox-first: läuft ohne echte 3D-Assets. + +## Rechtehinweis +Fan-Projekt zum Privatgebrauch. Eigennamen und Weltbegriffe der Vorlage sind +IP der Autorin/des Verlags. Für einen etwaigen öffentlichen Release: eigener +Titel + umbenannte Eigennamen. Assets nur CC0/CC-BY, mit `CREDITS.md`. diff --git a/assets/.gitkeep b/assets/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/assets/audio/.gitkeep b/assets/audio/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/assets/models/.gitkeep b/assets/models/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/assets/ui/.gitkeep b/assets/ui/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/data/.gitkeep b/data/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/data/dialogue/.gitkeep b/data/dialogue/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/data/dragons/.gitkeep b/data/dragons/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/data/signets/.gitkeep b/data/signets/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/data/story/.gitkeep b/data/story/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/docs/.gitkeep b/docs/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/docs/ASSETS.md b/docs/ASSETS.md new file mode 100644 index 0000000..2cd42c6 --- /dev/null +++ b/docs/ASSETS.md @@ -0,0 +1,51 @@ +# ASSETS.md — Windgeschworen + +> Kostenlose, legale Bezugsquellen. GREYBOX-FIRST: Assets sind Politur, kein +> Blocker. Das Spiel läuft komplett mit Primitiven, bevor hier irgendwas +> importiert wird. + +## Lizenz-Kurzregel +- **CC0** — mach was du willst, keine Namensnennung nötig. Bevorzugt. +- **CC-BY** — frei nutzbar, aber Credit in `CREDITS.md` pflegen. +- **CC-BY-NC** — nur nicht-kommerziell + Credit. Für privates Projekt ok, aber + falls je Release: meiden. +- Für jedes importierte Asset: Quelle + Lizenz in `CREDITS.md` eintragen. + +## Charaktere (Tyrveil, NPCs) +- **KayKit – Character Pack: Adventurers** (itch.io) — rigged + animierte + Low-Poly-Charaktere, CC0. Basis für Kadetten. +- **Quaternius** (quaternius.com) — tausende CC0-Modelle, rigged + animiert, + laufen direkt in Godot. +- **Mixamo** (Adobe, Login gratis) — rigged Charaktere + Motion-Capture- + Animationen (Laufen, Kampf, Idle), kostenlos, ohne Namensnennung, inkl. + Auto-Rigging. Haupt-Animationsquelle. Export → glTF/Blender → Godot. + +## Umgebung (Reiterquadrant, Schlafsaal, Klassenraum, Viadukt) +- **Kenney.nl** — 40.000+ Assets, alle CC0, ohne Anmeldung. +- **Quaternius Medieval / Nature MegaKits** — modulare Gebäude + Natur, CC0. + +## Drachen +- **Meshy** (meshy.ai) — Drachen unter CC0, royalty-free, ohne Namensnennung + (.FBX/.GLB). +- **Free3D** — u.a. rigged, game-ready "Black Dragon". +- **Sketchfab** — Filter "Downloadable" + Lizenz CC0/CC-BY. +- **BlendSwap** — Low-Poly-Drachen; viele CC-BY-NC (Credit + non-commercial). +- **STRATEGIE**: Bindungs-Tabelle ist farbbasiert → EIN gutes Basis-Drachenmesh + + Material-Einfärbung in Godot = alle Farben gratis. Schwanztypen später als + simple Mesh-Anhängsel. Du brauchst nicht zehn Drachen, sondern einen guten. + +## UI / Controller-Prompts +- **Kenney Input Prompts** — CC0. Xbox- UND PlayStation-Glyphen für dynamische + Button-Prompts (Ⓐ / ✕ je erkanntem Controller). + +## Texturen, Himmel, Materialien +- **Poly Haven** — CC0 Texturen, HDRIs, teils 3D-Modelle. +- **ambientCG** — 1500+ CC0-PBR-Materialien. + +## Audio (optional, später) +- **Freesound.org** — Filter CC0 für strings-free Nutzung. + +## Godot-spezifisch +- **Godot Asset Library** — Filter CC0 für Addons/Tools. +- Import: Godot mag **glTF/.glb** am liebsten. Mixamo-FBX ggf. über Blender nach + glTF konvertieren. diff --git a/docs/CHARACTERS.md b/docs/CHARACTERS.md new file mode 100644 index 0000000..6f272ec --- /dev/null +++ b/docs/CHARACTERS.md @@ -0,0 +1,87 @@ +# CHARACTERS.md — Windgeschworen + +> Charakter-Bibel. Jeder Dialog muss konsistent zu diesen Stimmen sein. + +## Tyrveil (Protagonist) + +### Kern-Dualität +Hart wie Xaden, liebevoll wie Violet. Kein Wechselschalter, sondern ein +ständiger innerer Konflikt. Die Härte hat ihn am Leben gehalten; die Weichheit +hält ihn menschlich. Er hat sich BEWUSST entschieden, sich vom Krieg nicht zur +reinen Klinge schleifen zu lassen — das ist sein leiser Aufstand. In v1 lernt er, +dass genau diese Weichheit das Erbe seines Vaters ist (STORY.md, Wahrheit 2). + +### Herkunft +Kind der Rebellion. Sein Vater war Anführer, wurde nach dem Scheitern öffentlich +als "gescheiterter Feigling" hingerichtet. Als Kind mit dem Rebellen-Relikt +gezeichnet → lebenslanger Verdacht, Zwangs-Rekrutierung in den Reiterquadrant. +Aufgewachsen im Schutz der anderen Gezeichneten. + +### Die Klinge (Xaden-Seite) +- Bewacht, wortkarg, scannt jeden Raum nach Bedrohungen. +- Tödlich kompetent, unterschätzt sich nie. +- Reflexhaftes Misstrauen gegen Autorität. +- Kalte Kalkulation, wenn es seine Leute schützt. +- Vergibt Verrat nicht. Wird er kalt, wird es still im Raum. + +### Das Herz (Violet-Seite) +- Erbittert loyal, zärtlich zu denen, die er liebt. +- Merkt sich die kleinen Dinge, flickt Leute zusammen (Wunden UND Seelen). +- Glaubt an zweite Chancen. Trockener, warmer Humor. +- Wählt Freundlichkeit als Trotz. + +### Fehler (wichtig für Tiefe) +- Überbeschützend bis kontrollierend; zieht Risiken auf sich. +- Trägt Schuld an etwas Dunklem, das er tat, um jemanden zu retten. +- Lässt außerhalb seines Kreises kaum jemanden rein. +- In die Enge getrieben kippt die Härte in echte Grausamkeit — er weiß es, und + es macht ihm Angst. + +### Stimme +Trocken, untertrieben, spart mit Worten bis er vertraut. Galgenhumor. Sagt viel +mit einem Blick. Seine seltenen offenen Bekenntnisse treffen gerade DESHALB hart. + +## Imogen +Nach außen nur Kanten — bei Tyrveil muss sie sich nicht panzern. Liebe als +Loyalität unter Beschuss. Trägt eigene Trauer: Ihre jüngeren Geschwister gehören +zu den Kindern, die Tyrveils Vater damals rettete — sie weiß es lange vor +Tyrveil und ringt damit, wann sie es sagt. Intimität ist verdient, zärtlich +hinter verschlossenen Türen, getestet durch Gefahr und Geheimnisse. + +## Violet +Verbündete und Freundin, mit der Tyrveil durch die Gegend rennt — NICHT die +Heldin dieser Geschichte. Wärme, Neugier, unerwartete Zähigkeit. Tyrveil +beschützt ihren weichen Kern, weil er den Teil von ihm spiegelt, den er sich +weigert zu töten. Fast geschwisterlich. + +## Xaden +Anführer der Gezeichneten. Trägt dieselbe Last wie Tyrveil, nur länger. +Bruderschaft, geteilte Kommando-Bürde, tiefer Respekt — gelegentlich Reibung +darüber, wie weit man geht, um die eigenen Leute zu schützen. Kein Love Interest. + +## Liam +Tyrveils engster Freund unter den Erstjahren. In v1 lebendig, strahlend, loyal — +Sticheleien und erbitterte Schutzhaltung in beide Richtungen. Der Leser ahnt den +Verlust, der kommt; das macht jede leichte Szene mit ihm kostbar. Haken für +später, in v1 NICHT sterben. + +## Wren Calloran (Original) +16, jüngster Gezeichneter des Jahrgangs. Warm, klug, ängstlich, tapferer als er +glaubt. Ohne es zu wissen von Tyrveils Vater gerettet — eins der Kinder von +damals. Emotionaler Anker und verkörperte Hoffnung. Klammert sich nach dem +Wendepunkt an Tyrveil. MUSS bei guten Entscheidungen überleben. + +## Maren Vael (Original) +Drittjahr, gezeichnet, gebunden. Große Schwester der Gezeichneten, still, warm, +unerschütterlich. Kannte Tyrveils Vater und trägt die Wahrheit über seinen Tod. +Stirbt am Wendepunkt (Gauntlet), um die Erstjahr-Gezeichneten zu retten — fixer +Verlust im Liam-Register. Ihr Tod liefert Wahrheit 2 und stürzt eine Lüge. +Menschlich, nicht heilig: sie hat Angst, macht Witze, und geht trotzdem. + +## Nebenfiguren (v1) +- **Rhiannon** — warmherzige, loyale Freundin; früher Vertrauensanker. +- **Dain** — verkörpert Autorität und Regeltreue; natürliche Reibung mit + Tyrveils Misstrauen. Nicht böse, nur auf der anderen Seite der Linie. +- **Sawyer / Ridoc** — Squad-Kameraden; Ridoc bringt Humor, Sawyer Bodenhaftung. +- **Lehrer** — Kampf, Landnavigation, Geschichte/RSC, Drachenkunde. Einer von + ihnen ist verwickelt in die Aussonderung (Haken, in v1 nur angedeutet). diff --git a/docs/SPEC.md b/docs/SPEC.md new file mode 100644 index 0000000..7f08987 --- /dev/null +++ b/docs/SPEC.md @@ -0,0 +1,121 @@ +# SPEC.md — Windgeschworen + +> Single Source of Truth. Claude Code liest dieses Dokument (plus STORY.md, +> CHARACTERS.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: CHARACTERS.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) +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** — Tageszyklus + Stats + Save/Load + Greybox-Hub (Reiterquadrant, + Schlafsaal, Klassenraum). +- **Phase 2** — Dialog-System + erste NPCs (Violet, Imogen, Rhiannon, Wren). +- **Phase 3** — Viadukt-Set-Piece + Charakter-Anlage + Klinge/Herz-Achse. +- **Phase 4** — Unterricht, Gauntlet, Beziehungs-/Fraktions-Logik, + Maren-Wendepunkt (Wahrheit 1 & 2). +- **Phase 5** — Dreschen + Bindungs-RNG + Signet-Reveal + Wahrheit 3 + Teaser. +- **Phase 6** — Codex, Mature-Gate, Permadeath-Toggle, Button-Prompts, Polish. + +## 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). diff --git a/docs/STORY.md b/docs/STORY.md new file mode 100644 index 0000000..bf9d38f --- /dev/null +++ b/docs/STORY.md @@ -0,0 +1,156 @@ +# STORY.md — Windgeschworen (v1) + +> Kanon-Quelle für alle Dialoge, Szenen und Story-Daten. Claude Code erfindet +> keine Handlung über dieses Dokument hinaus. Was hier steht, ist wahr. + +## 1. Ton & Versprechen +Traurig wie Liams Weg — aber hoffnungsvoll. Kein Grimdark. Der Verlust in dieser +Geschichte **setzt etwas frei**: Er nimmt Tyrveil eine lebenslange Last von den +Schultern, statt nur weh zu tun. Trauer und Licht laufen ineinander. Am Ende +weint der Spieler vielleicht — aber er atmet auch tiefer. + +Faustregel für jede Szene: *Wenn es wehtut, muss darin ein Funke Hoffnung +liegen. Wenn es hoffnungsvoll ist, darf die Trauer mitschwingen.* + +## 2. Prämisse +Die Gezeichneten — Kinder der gescheiterten Rebellion, mit dem Relikt am Rücken +gebrandmarkt — werden in den Reiterquadrant gesteckt, weil man dort am +elegantesten stirbt. Offiziell ist das Zufall. In Wahrheit ist es eine stille +**Aussonderung**: Man erwartet, dass die Gezeichneten das erste Jahr nicht +überleben, und richtet die Bedingungen still darauf aus. + +Tyrveil weiß das im Bauch, kann es aber nicht beweisen. Sein selbst gewählter +Auftrag: **seine Leute durch das erste Jahr bringen. Vor allem die Jüngsten.** +Er trägt die Schuld seines Vaters wie einen Mühlstein — des Rebellenanführers, +der hingerichtet wurde und dessen "Versagen" alle Gezeichneten markiert hat. + +## 3. Die drei Wahrheiten (Was Tyrveil erfährt) +Das erzählerische Rückgrat. Jede Wahrheit ist ein Schlag — und jede dreht sich +in Hoffnung. + +**Wahrheit 1 — Die Aussonderung ist gewollt, nicht Zufall.** +Über die Tage bemerkt Tyrveil das Muster: Gezeichnete kriegen die schlechtesten +Gauntlet-Zeiten, die tödlichsten Squad-Positionen, die aussichtslosesten +Paarungen. Es ist kein Pech. Jemand rechnet mit ihren Leichen. +→ Hoffnung: Wer ein System durchschaut, kann es unterlaufen. + +**Wahrheit 2 — Sein Vater war kein Versager. Er starb aus Liebe.** +Der Kern. Die offizielle Geschichte ist eine Lüge. Tyrveils Vater hätte fliehen +können, als die Rebellion zusammenbrach. Stattdessen blieb er und stellte sich +zwischen die Soldaten und die Kinder der Rebellen — darunter Imogens jüngere +Geschwister und ein kleiner Junge namens Wren. Er kaufte ihnen mit seinem Leben +die Flucht. Man ließ ihn als "Feigling, der scheiterte" hinrichten, weil ein +M¤rtyrer gefährlich gewesen wäre. +→ Tyrveils lebenslange Scham kippt in Trauer *und* Stolz. Die Weichheit, für die +er seinen Vater insgeheim verachtete, war das Tapferste an ihm. Das ist der +Moment, der Tyrveils eigene Klinge-↔-Herz-Frage beantwortet. + +**Wahrheit 3 — Die Drachen wählen die Gezeichneten bewusst.** +Beim Dreschen begreift Tyrveil: Die Drachen sind nicht neutral. Manche wählen +gezeichnete Reiter *gerade wegen* dessen, was sie sind — ungebrochen, loyal, +resistent gegen die Korruption, die im Verborgenen wächst. Gewählt zu werden ist +kein Glück, sondern **Wiedererkennen**. Die Bindung eines Gezeichneten ist der +stille Widerstand der Drachen gegen die Aussonderung. +→ Hoffnung pur: Die Macht, die man den Gezeichneten verweigern wollte, wählt +sie selbst. + +**Angelegter Haken (nicht ausgespielt in v1):** Wofür die Rebellion *wirklich* +kämpfte. Es gibt eine Bedrohung jenseits der Grenze, die das Königreich +verschweigt (Venin/Wyvern). Tyrveils Vater wusste davon. Das ist der rote Faden +für spätere Phasen. + +## 4. Figuren im Zentrum +- **Wren Calloran** — 16, der jüngste Gezeichnete des Jahrgangs. Warm, klug, + ängstlich, tapferer als er glaubt. Tyrveil hat ihn ohne es zu wissen schon + einmal gerettet: Wren ist eins der Kinder, für die Tyrveils Vater starb. + Emotionaler Anker. Wren MUSS bei guten Spielentscheidungen überleben — er ist + die verkörperte Hoffnung. +- **Maren Vael** — Drittjahr, gezeichnet, gebunden. Die große Schwester der + Gezeichneten, die still über die Erstjahre wacht. Kannte Tyrveils Vater. + Sie ist die, die stirbt — wie Liam, im Schutz der anderen. Ihr Tod liefert + Wahrheit 2. +- **Imogen** — Tyrveils Partnerin. Zwei scharfe Menschen, die Sanftheit nur + miteinander finden. Trägt eigene Trauer (ihre Geschwister gehören zu den + Geretteten von damals). Beziehung unter Druck. +- **Violet** — Verbündete und Freundin, mit der Tyrveil durch die Gegend rennt. + Spiegelt die Wärme, die er sich weigert abzutöten. Fast geschwisterlich. +- **Xaden** — Anführer der Gezeichneten. Trägt dieselbe Last wie Tyrveil. + Verbündeter, kein Love Interest. +- **Liam** — Bruder im Geiste, Tyrveils engster Freund unter den Erstjahren. + In v1 lebendig und strahlend — sein Schatten (das Wissen des Lesers um sein + Schicksal) macht jede leichte Szene mit ihm kostbar. Haken für später. + +## 5. Akt-Struktur (an den Core Loop gekoppelt) +Die Story sitzt exakt auf dem spielbaren v1-Loop. + +**Prolog — Das Viadukt.** +Erster Schritt, erster Tod möglich. Auf halbem Weg gerät Wren ins Straucheln. +Tyrveil kann ihn halten (Klinge: hart zupacken, ihn anbrüllen, weiterzwingen / +Herz: ruhig reden, ihn durch die Angst tragen). Erste Etablierung: Tyrveils +Rolle, die Todesgefahr, die Bindung zu Wren. Beide Wege retten ihn — aber +Wren erinnert sich, *wie*. + +**Akt 1 — Die Tage.** +3–4 durchspielbare Tage: Unterricht, Schlafsaal, NPC-Gespräche. Hier wächst +alles Menschliche — und die ersten Risse zeigen sich. Tyrveil sammelt die +Puzzleteile von Wahrheit 1. Imogen-Intimität in den Abendstunden (Beziehung +unter Druck, Ton je nach Mature-Toggle). Maren tauct als ruhige, wissende +Präsenz auf und lässt Andeutungen über Tyrveils Vater fallen, die er noch nicht +einordnen kann. + +**Wendepunkt — Der Gauntlet.** +Der Gauntlet-Lauf der Gezeichneten ist manipuliert (Auszahlung von Wahrheit 1): +eine absichtlich tödliche Konstellation. Maren durchschaut es und wirft sich +dazwischen, um die Erstjahr-Gezeichneten — allen voran Wren — herauszuholen. +Sie stirbt dabei. Der Verlust ist **fix** (wie Liams Tod): nicht verhinderbar, +nur in seiner Bedeutung formbar. Sterbend (oder über einen hinterlassenen Brief) +gibt sie Tyrveil Wahrheit 2: die echte Geschichte seines Vaters. + +**Akt 2 — Trauer & Entschluss.** +Kurz, schwer, entscheidend. Wie trägt Tyrveil den Verlust? Die Klinge-↔-Herz- +Achse färbt es: Rückzug in kalte Wut (Klinge) oder das Bündeln der Trauernden zu +etwas Wärmerem und Stärkerem (Herz). Die Gezeichneten rücken enger zusammen. +Imogen und Tyrveil halten sich — oder stoßen sich unter der Last, je nach +Beziehungswert. Wren, gerettet, weicht Tyrveil nicht mehr von der Seite. + +**Klimax — Das Dreschen.** +Der hoffnungsvolle Höhepunkt. Wahrheit 3 wird erfahrbar. Die Bindung läuft über +das RNG-System (siehe SPEC), aber narrativ gerahmt als Trotz: Ein Drache wählt +Tyrveil — und bei bestimmten Bedingungen (Herz-Pfad, hohe Wren-/Maren-Bindung) +steigt die Chance auf einen **Federschwanz** (der ungebrochene Herzen erkennt) +oder einen Drachen, dessen frühere:r Reiter:in mit Tyrveils Vater verbunden war. +Das ist kein garantierter Ausgang — aber der Daumen auf der Waage, den du +wolltest. + +**Epilog / Teaser — Der erste Flug.** +Tyrveil in der Luft, Imogen neben ihm, Wren am Boden, der heraufwinkt. Trauer und +Hoffnung verwoben. Ein stiller Schwur: die Jungen schützen, die ganze Wahrheit +ausgraben. Letzter Beat: eine Andeutung der größeren Bedrohung (Haken). Schnitt. +Ende v1. + +## 6. Verzweigung nach Klinge ↔ Herz +Kein Gut/Böse. Beide Wege sind gültig, beide sind Tyrveil. Sie färben dieselben +Beats: +- **Viadukt:** wie Wren gerettet wird (prägt seine Sicht auf Tyrveil). +- **Die Tage:** welche NPCs sich öffnen (Imogen respektiert die Klinge, Violet + das Herz, Dain will Berechenbarkeit). +- **Marens Tod:** ob Tyrveil in Rache erstarrt oder die Trauernden sammelt — + bestimmt das Fraktions-Standing danach. +- **Dreschen:** verschiebt den Kompatibilitäts-Daumen (welche Drachen sich + zuneigen). +- **Angelegt:** ein verdeckter Menschlichkeits-Messwert trackt, wie weit Tyrveil + zur reinen Klinge driftet (Resonanz zum Korruptions-/Venin-Motiv). In v1 nur + gesammelt, nicht ausgespielt. + +## 7. Warum es hoffnungsvoll endet +- Wren lebt. Die verkörperte Hoffnung übersteht das tödlichste Jahr. +- Tyrveils Scham ist fort — an ihre Stelle tritt Stolz und ein geerbter Auftrag. +- Die Gezeichneten haben Drachen: Macht, die man ihnen nicht mehr nehmen kann. +- Maren ist tot, aber ihr Tod hat etwas gerettet UND eine Lüge gestürzt — er war + nicht umsonst. Das ist der Unterschied zwischen traurig und hoffnungslos. + +## 8. Haken für spätere Phasen +- Die wahre Bedrohung (Venin/Wyvern), von der Tyrveils Vater wusste. +- Wer die Aussonderung anordnet — der Kopf hinter dem Muster. +- Liams Schatten: der Verlust, der noch kommt. +- Der Menschlichkeits-Messwert wird spielrelevant. diff --git a/project.godot b/project.godot new file mode 100644 index 0000000..cbcbee5 --- /dev/null +++ b/project.godot @@ -0,0 +1,114 @@ +config_version=5 + +[application] + +config/name="Windgeschworen" +config/description="Third-Person-RPG - erstes Ausbildungsjahr an einer Drachenreiter-Akademie. Privates Fan-Projekt." +run/main_scene="res://scenes/test_ground.tscn" +config/features=PackedStringArray("4.3", "Forward Plus") + +[autoload] + +GameState="*res://scripts/autoloads/game_state.gd" +SaveSystem="*res://scripts/autoloads/save_system.gd" +DialogueSystem="*res://scripts/autoloads/dialogue_system.gd" +TimeSystem="*res://scripts/autoloads/time_system.gd" +RelationshipSystem="*res://scripts/autoloads/relationship_system.gd" +FactionSystem="*res://scripts/autoloads/faction_system.gd" +DragonBondSystem="*res://scripts/autoloads/dragon_bond_system.gd" +SignetSystem="*res://scripts/autoloads/signet_system.gd" +StorySystem="*res://scripts/autoloads/story_system.gd" +InputPrompts="*res://scripts/autoloads/input_prompts.gd" +MatureContentGate="*res://scripts/autoloads/mature_content_gate.gd" + +[display] + +window/stretch/mode="canvas_items" +window/stretch/aspect="expand" + +[input] + +move_forward={ +"deadzone": 0.2, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":87,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +, Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":1,"axis_value":-1.0,"script":null) +] +} +move_back={ +"deadzone": 0.2, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":83,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +, Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":1,"axis_value":1.0,"script":null) +] +} +move_left={ +"deadzone": 0.2, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":65,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +, Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":0,"axis_value":-1.0,"script":null) +] +} +move_right={ +"deadzone": 0.2, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":68,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +, Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":0,"axis_value":1.0,"script":null) +] +} +look_x={ +"deadzone": 0.2, +"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":2,"axis_value":-1.0,"script":null) +, Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":2,"axis_value":1.0,"script":null) +] +} +look_y={ +"deadzone": 0.2, +"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":3,"axis_value":-1.0,"script":null) +, Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":3,"axis_value":1.0,"script":null) +] +} +camera_zoom_in={ +"deadzone": 0.2, +"events": [Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":0,"position":Vector2(0, 0),"global_position":Vector2(0, 0),"factor":1.0,"button_index":4,"canceled":false,"pressed":false,"double_click":false,"script":null) +, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":10,"pressure":0.0,"pressed":false,"script":null) +] +} +camera_zoom_out={ +"deadzone": 0.2, +"events": [Object(InputEventMouseButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"button_mask":0,"position":Vector2(0, 0),"global_position":Vector2(0, 0),"factor":1.0,"button_index":5,"canceled":false,"pressed":false,"double_click":false,"script":null) +, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":9,"pressure":0.0,"pressed":false,"script":null) +] +} +interact={ +"deadzone": 0.2, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":69,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":0,"pressure":0.0,"pressed":false,"script":null) +] +} +confirm={ +"deadzone": 0.2, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194309,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":0,"pressure":0.0,"pressed":false,"script":null) +] +} +cancel={ +"deadzone": 0.2, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194305,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":1,"pressure":0.0,"pressed":false,"script":null) +] +} +menu={ +"deadzone": 0.2, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194306,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":6,"pressure":0.0,"pressed":false,"script":null) +] +} +journal={ +"deadzone": 0.2, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":74,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":3,"pressure":0.0,"pressed":false,"script":null) +] +} +sprint={ +"deadzone": 0.2, +"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":4194325,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null) +, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":7,"pressure":0.0,"pressed":false,"script":null) +] +} diff --git a/prompts/.gitkeep b/prompts/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/prompts/README.md b/prompts/README.md new file mode 100644 index 0000000..7ddf1da --- /dev/null +++ b/prompts/README.md @@ -0,0 +1,5 @@ +# Prompts + +Phasenweise an Claude Code geben. Immer erst die Docs lesen lassen. +Reihenfolge: phase-0 → phase-1 → ... (siehe SPEC.md, Abschnitt 10). +Nach jeder Phase testen und committen, bevor die nächste startet. diff --git a/prompts/phase-0.md b/prompts/phase-0.md new file mode 100644 index 0000000..acaef61 --- /dev/null +++ b/prompts/phase-0.md @@ -0,0 +1,46 @@ +# Phase 0 — Kickoff-Prompt für Claude Code + +Du arbeitest an "Windgeschworen", einem Third-Person-RPG in Godot 4.3 (GDScript). + +ZUERST, bevor du irgendetwas tust: Lies `docs/SPEC.md`, `docs/STORY.md` und +`docs/CHARACTERS.md` vollständig. Diese Dokumente sind die verbindliche Source of +Truth. Erfinde keine Handlung über STORY.md hinaus. Halte dich strikt an die +Namens-Konvention und Regeln aus SPEC.md, Abschnitt 3 (u.a.: keine +Inline-Kommentare; erlaubt sind `##`-Doku-Blöcke über Funktionen und Klassen). + +Deine Aufgabe ist NUR Phase 0. Baue nicht voraus. Ziel von Phase 0: ein +lauffähiges Greybox-Fundament, das ich sofort mit Tastatur UND Controller testen +kann. + +Umfang Phase 0: +1. Prüfe die vorhandene Ordnerstruktur (docs/, scenes/, scripts/, data/, + assets/) und ergänze nur, was fehlt. Nichts Bestehendes überschreiben. +2. Input-Map: Verdrahte in `project.godot` alle Input-Actions aus SPEC.md + Abschnitt 9 — Tastatur + Xbox/PS5 (Deadzone 0.2). Nutze physische Keycodes. +3. Autoload-Skelette anlegen (SPEC.md Abschnitt 8): leere, aber sauber + dokumentierte Singletons (`GameState`, `SaveSystem`, `DialogueSystem`, + `TimeSystem`, `RelationshipSystem`, `FactionSystem`, `DragonBondSystem`, + `SignetSystem`, `StorySystem`, `InputPrompts`, `MatureContentGate`) unter + `scripts/autoloads/` und in `project.godot` registrieren. Nur Struktur + + Doku-Blöcke, noch keine Logik. +4. Greybox-Testszene `scenes/test_ground.tscn`: + - Ebener Boden (StaticBody3D + Box), ein paar Box-Hindernisse. + - Spieler als CharacterBody3D mit Kapsel-Mesh. + - Third-Person-Kamera weit rausgezoomt (WoW-Style) via SpringArm3D, mit + Zoom (camera_zoom_in/out) und Kollision. Look über Maus + rechten Stick. + - Bewegung relativ zur Kamera, Sprint-Action, springen optional. + - WorldEnvironment mit simplem Licht, damit man was sieht. +5. Debug-Overlay (CanvasLayer): zeigt FPS, aktives Eingabegerät + (Tastatur/Xbox/PS5), Spielerposition, Kamera-Zoom. +6. Setze `scenes/test_ground.tscn` als Main Scene. + +Qualität & Vorgehen: +- Arbeite in kleinen, nachvollziehbaren Schritten. Erkläre kurz, was du tust. +- Datei-/Ordnerpfade konsequent laut SPEC. +- Committe am Ende mit sinnvoller Message (kein Auto-Push). +- Am Ende: kurze Zusammenfassung + genaue Test-Anleitung (welche Szene starten, + welche Tasten/Buttons), und liste offene Punkte für Phase 1. +- STOPP nach Phase 0. Warte auf mein Review, bevor du Phase 1 beginnst. + +Wenn etwas in den Docs unklar oder widersprüchlich ist: frag nach, statt zu +raten. diff --git a/scenes/.gitkeep b/scenes/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/scenes/test_ground.tscn b/scenes/test_ground.tscn new file mode 100644 index 0000000..b332434 --- /dev/null +++ b/scenes/test_ground.tscn @@ -0,0 +1,164 @@ +[gd_scene load_steps=19 format=3] + +[ext_resource type="Script" path="res://scripts/gameplay/player.gd" id="1_player"] +[ext_resource type="Script" path="res://scripts/ui/debug_overlay.gd" id="2_debug"] + +[sub_resource type="ProceduralSkyMaterial" id="ProceduralSkyMaterial_sky"] +sky_horizon_color = Color(0.64625, 0.65575, 0.67075, 1) +ground_horizon_color = Color(0.64625, 0.65575, 0.67075, 1) + +[sub_resource type="Sky" id="Sky_sky"] +sky_material = SubResource("ProceduralSkyMaterial_sky") + +[sub_resource type="Environment" id="Environment_env"] +background_mode = 2 +sky = SubResource("Sky_sky") +tonemap_mode = 2 + +[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_ground"] +albedo_color = Color(0.35, 0.38, 0.4, 1) + +[sub_resource type="BoxShape3D" id="BoxShape3D_ground"] +size = Vector3(60, 1, 60) + +[sub_resource type="BoxMesh" id="BoxMesh_ground"] +material = SubResource("StandardMaterial3D_ground") +size = Vector3(60, 1, 60) + +[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_obstacle"] +albedo_color = Color(0.55, 0.45, 0.35, 1) + +[sub_resource type="BoxShape3D" id="BoxShape3D_cube_small"] +size = Vector3(2, 2, 2) + +[sub_resource type="BoxMesh" id="BoxMesh_cube_small"] +material = SubResource("StandardMaterial3D_obstacle") +size = Vector3(2, 2, 2) + +[sub_resource type="BoxShape3D" id="BoxShape3D_cube_big"] +size = Vector3(4, 4, 4) + +[sub_resource type="BoxMesh" id="BoxMesh_cube_big"] +material = SubResource("StandardMaterial3D_obstacle") +size = Vector3(4, 4, 4) + +[sub_resource type="BoxShape3D" id="BoxShape3D_wall"] +size = Vector3(8, 2, 1) + +[sub_resource type="BoxMesh" id="BoxMesh_wall"] +material = SubResource("StandardMaterial3D_obstacle") +size = Vector3(8, 2, 1) + +[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_player"] +albedo_color = Color(0.3, 0.5, 0.85, 1) + +[sub_resource type="CapsuleShape3D" id="CapsuleShape3D_player"] +radius = 0.4 +height = 1.8 + +[sub_resource type="CapsuleMesh" id="CapsuleMesh_player"] +material = SubResource("StandardMaterial3D_player") +radius = 0.4 +height = 1.8 + +[node name="TestGround" type="Node3D"] + +[node name="WorldEnvironment" type="WorldEnvironment" parent="."] +environment = SubResource("Environment_env") + +[node name="Sun" type="DirectionalLight3D" parent="."] +transform = Transform3D(0.866025, 0.383022, -0.321394, 0, 0.642788, 0.766044, 0.5, -0.663414, 0.55667, 0, 12, 0) +shadow_enabled = true + +[node name="Ground" type="StaticBody3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, -0.5, 0) + +[node name="CollisionShape3D" type="CollisionShape3D" parent="Ground"] +shape = SubResource("BoxShape3D_ground") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="Ground"] +mesh = SubResource("BoxMesh_ground") + +[node name="Obstacles" type="Node3D" parent="."] + +[node name="BoxEast" type="StaticBody3D" parent="Obstacles"] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 4, 1, 2) + +[node name="CollisionShape3D" type="CollisionShape3D" parent="Obstacles/BoxEast"] +shape = SubResource("BoxShape3D_cube_small") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="Obstacles/BoxEast"] +mesh = SubResource("BoxMesh_cube_small") + +[node name="BoxSouth" type="StaticBody3D" parent="Obstacles"] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, -3, 1, 5) + +[node name="CollisionShape3D" type="CollisionShape3D" parent="Obstacles/BoxSouth"] +shape = SubResource("BoxShape3D_cube_small") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="Obstacles/BoxSouth"] +mesh = SubResource("BoxMesh_cube_small") + +[node name="BoxNorth" type="StaticBody3D" parent="Obstacles"] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 7, 1, -5) + +[node name="CollisionShape3D" type="CollisionShape3D" parent="Obstacles/BoxNorth"] +shape = SubResource("BoxShape3D_cube_small") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="Obstacles/BoxNorth"] +mesh = SubResource("BoxMesh_cube_small") + +[node name="BigBox" type="StaticBody3D" parent="Obstacles"] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, -6, 2, -4) + +[node name="CollisionShape3D" type="CollisionShape3D" parent="Obstacles/BigBox"] +shape = SubResource("BoxShape3D_cube_big") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="Obstacles/BigBox"] +mesh = SubResource("BoxMesh_cube_big") + +[node name="Wall" type="StaticBody3D" parent="Obstacles"] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 1, -8) + +[node name="CollisionShape3D" type="CollisionShape3D" parent="Obstacles/Wall"] +shape = SubResource("BoxShape3D_wall") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="Obstacles/Wall"] +mesh = SubResource("BoxMesh_wall") + +[node name="Player" type="CharacterBody3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.1, 6) +collision_layer = 2 +collision_mask = 1 +script = ExtResource("1_player") + +[node name="CollisionShape3D" type="CollisionShape3D" parent="Player"] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.9, 0) +shape = SubResource("CapsuleShape3D_player") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="Player"] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.9, 0) +mesh = SubResource("CapsuleMesh_player") + +[node name="CameraPivot" type="Node3D" parent="Player"] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 1.5, 0) + +[node name="SpringArm3D" type="SpringArm3D" parent="Player/CameraPivot"] +transform = Transform3D(1, 0, 0, 0, 0.939693, 0.34202, 0, -0.34202, 0.939693, 0, 0, 0) +spring_length = 9.0 +margin = 0.25 + +[node name="Camera3D" type="Camera3D" parent="Player/CameraPivot/SpringArm3D"] + +[node name="DebugOverlay" type="CanvasLayer" parent="."] +script = ExtResource("2_debug") +player_path = NodePath("../Player") + +[node name="InfoLabel" type="Label" parent="DebugOverlay"] +offset_left = 12.0 +offset_top = 8.0 +offset_right = 420.0 +offset_bottom = 128.0 +theme_override_colors/font_color = Color(1, 1, 1, 1) +theme_override_colors/font_outline_color = Color(0, 0, 0, 1) +theme_override_constants/outline_size = 4 diff --git a/scripts/.gitkeep b/scripts/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/scripts/autoloads/.gitkeep b/scripts/autoloads/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/scripts/autoloads/dialogue_system.gd b/scripts/autoloads/dialogue_system.gd new file mode 100644 index 0000000..a3f7422 --- /dev/null +++ b/scripts/autoloads/dialogue_system.gd @@ -0,0 +1,7 @@ +extends Node +## Daten-getriebenes Dialog-System (Autoload, SPEC.md Abschnitte 6 und 8). +## +## Spielt ab Phase 2 verzweigte Dialogbäume aus data/dialogue ab. +## Entscheidungen tragen Klinge/Herz-Tags und wirken auf den Ton-Wert, auf +## Beziehungswerte und auf Story-Flags. Die Dialog-UI ist fokus-navigierbar +## (D-Pad/Stick). Phase 0: leeres Skelett ohne Logik. diff --git a/scripts/autoloads/dragon_bond_system.gd b/scripts/autoloads/dragon_bond_system.gd new file mode 100644 index 0000000..725fbbb --- /dev/null +++ b/scripts/autoloads/dragon_bond_system.gd @@ -0,0 +1,10 @@ +extends Node +## Drachen-Bindung beim Dreschen (Autoload, SPEC.md Abschnitte 6 und 8). +## +## Würfelt ab Phase 5 die Drachenart über eine gewichtete Zufalls-Tabelle aus +## data/dragons (Farbe + Schwanztyp, selten Schwarz ~5 % und Federschwanz +## ~4 %). Der Bindungs-Erfolg kombiniert Basis-Zufall mit einem leichten +## Kompatibilitäts-Daumen aus Klinge/Herz, Spielweise und Story-Flags +## (Wren-/Maren-Bindung, STORY.md Abschnitt 5, Klimax). Drachen können +## ablehnen; bei Permadeath AN kann Scheitern tödlich sein. Phase 0: leeres +## Skelett ohne Logik. diff --git a/scripts/autoloads/faction_system.gd b/scripts/autoloads/faction_system.gd new file mode 100644 index 0000000..6e5b275 --- /dev/null +++ b/scripts/autoloads/faction_system.gd @@ -0,0 +1,7 @@ +extends Node +## Squad-Ansehen und Fraktions-Standing (Autoload, SPEC.md Abschnitte 6 und 8). +## +## Verwaltet ab Phase 4 das Ansehen im Squad sowie das Standing bei der +## Fraktion der Gezeichneten, u. a. geprägt durch die Klinge-↔-Herz-Achse +## nach Marens Tod (STORY.md Abschnitt 6). Phase 0: leeres Skelett ohne +## Logik. diff --git a/scripts/autoloads/game_state.gd b/scripts/autoloads/game_state.gd new file mode 100644 index 0000000..c8ad344 --- /dev/null +++ b/scripts/autoloads/game_state.gd @@ -0,0 +1,7 @@ +extends Node +## Zentraler Spielzustand (Autoload, SPEC.md Abschnitt 8). +## +## Hält ab Phase 1 den Zustand eines Durchlaufs: Spieler-Stats (Kraft, +## Schnelligkeit, Verstand), den Klinge-↔-Herz-Ton-Wert (-100..+100), den +## verdeckten Menschlichkeits-Messwert, den Permadeath-Toggle (Default AN) +## sowie globale Spiel-Flags. Phase 0: leeres Skelett ohne Logik. diff --git a/scripts/autoloads/input_prompts.gd b/scripts/autoloads/input_prompts.gd new file mode 100644 index 0000000..d56d599 --- /dev/null +++ b/scripts/autoloads/input_prompts.gd @@ -0,0 +1,8 @@ +extends Node +## Dynamische Button-Prompts (Autoload, SPEC.md Abschnitte 2 und 8). +## +## Erkennt ab Phase 6 das zuletzt aktive Eingabegerät (Tastatur/Maus, Xbox- +## oder PS5-Controller) und liefert UI-weit die passenden Glyphen für +## Interaktions- und Menü-Prompts. Die provisorische Geräteerkennung des +## Phase-0-Debug-Overlays wandert dann hierher. Phase 0: leeres Skelett ohne +## Logik. diff --git a/scripts/autoloads/mature_content_gate.gd b/scripts/autoloads/mature_content_gate.gd new file mode 100644 index 0000000..2dd3ffb --- /dev/null +++ b/scripts/autoloads/mature_content_gate.gd @@ -0,0 +1,8 @@ +extends Node +## Mature-Content-Gate (Autoload, SPEC.md Abschnitte 6 und 8). +## +## Verwaltet ab Phase 6 das 18+-Gate beim ersten Start, die Content-Warnung +## und den Options-Toggle (Default AUS). Schaltet Romantik-Szenen zweigleisig: +## Fade-to-Black (Default) oder explizite Textvarianten aus gegateten +## Datendateien, die ausschließlich vom Nutzer gepflegt werden. Phase 0: +## leeres Skelett ohne Logik. diff --git a/scripts/autoloads/relationship_system.gd b/scripts/autoloads/relationship_system.gd new file mode 100644 index 0000000..3266b93 --- /dev/null +++ b/scripts/autoloads/relationship_system.gd @@ -0,0 +1,7 @@ +extends Node +## Beziehungswerte pro NPC (Autoload, SPEC.md Abschnitte 6 und 8). +## +## Führt ab Phase 4 pro NPC einen Beziehungswert (-100..+100), der durch +## Dialoge und Aktivitäten steigt oder fällt und Reaktionen sowie +## Story-Verzweigungen färbt (z. B. Imogen unter Druck, Wren-Bindung). +## Phase 0: leeres Skelett ohne Logik. diff --git a/scripts/autoloads/save_system.gd b/scripts/autoloads/save_system.gd new file mode 100644 index 0000000..b6f3363 --- /dev/null +++ b/scripts/autoloads/save_system.gd @@ -0,0 +1,7 @@ +extends Node +## Speichern und Laden von Spielständen (Autoload, SPEC.md Abschnitte 6 und 8). +## +## Serialisiert ab Phase 1 den Zustand der übrigen Systeme in Spielstände und +## stellt ihn wieder her. Berücksichtigt später den Permadeath-Modus (Ironman) +## gegenüber dem Story-Modus mit Checkpoints. Phase 0: leeres Skelett ohne +## Logik. diff --git a/scripts/autoloads/signet_system.gd b/scripts/autoloads/signet_system.gd new file mode 100644 index 0000000..e2a3cad --- /dev/null +++ b/scripts/autoloads/signet_system.gd @@ -0,0 +1,6 @@ +extends Node +## Signet-Vergabe nach der Bindung (Autoload, SPEC.md Abschnitte 6 und 8). +## +## Vergibt ab Phase 5 nach erfolgreicher Drachen-Bindung eine zufällige +## einzigartige Kraft aus der Signet-Tabelle in data/signets und rahmt den +## Reveal-Moment. Phase 0: leeres Skelett ohne Logik. diff --git a/scripts/autoloads/story_system.gd b/scripts/autoloads/story_system.gd new file mode 100644 index 0000000..59e700c --- /dev/null +++ b/scripts/autoloads/story_system.gd @@ -0,0 +1,8 @@ +extends Node +## Story-Beats und Story-Flags (Autoload, SPEC.md Abschnitt 8). +## +## Steuert ab Phase 3 den Fortschritt entlang der v1-Akt-Struktur (STORY.md +## Abschnitt 5): Viadukt, die Tage, Gauntlet, Trauer und Entschluss, +## Dreschen, Teaser. Beats und Flags liegen daten-getrieben in data/story; +## erfundene Handlung über STORY.md hinaus ist ausgeschlossen. Phase 0: +## leeres Skelett ohne Logik. diff --git a/scripts/autoloads/time_system.gd b/scripts/autoloads/time_system.gd new file mode 100644 index 0000000..2a65e1f --- /dev/null +++ b/scripts/autoloads/time_system.gd @@ -0,0 +1,6 @@ +extends Node +## Tageszyklus (Autoload, SPEC.md Abschnitte 6 und 8). +## +## Verwaltet ab Phase 1 die Tages-Slots Vormittag/Nachmittag/Abend über die +## 3-4 spielbaren Tage des v1-Loops; der Schlafsaal beendet den Tag. +## Phase 0: leeres Skelett ohne Logik. diff --git a/scripts/gameplay/.gitkeep b/scripts/gameplay/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/scripts/gameplay/player.gd b/scripts/gameplay/player.gd new file mode 100644 index 0000000..43ae281 --- /dev/null +++ b/scripts/gameplay/player.gd @@ -0,0 +1,130 @@ +extends CharacterBody3D +## Greybox-Spielersteuerung für Phase 0. +## +## Bewegt die Spieler-Kapsel relativ zur Kamera (WASD + linker Stick), +## unterstützt Sprint und steuert die weit rausgezoomte Third-Person-Kamera +## im WoW-Stil: Orbit über Maus und rechten Stick, Zoom über Mausrad und +## Schultertasten, Kollision über SpringArm3D. Die Actions look_x/look_y +## sind in der Input-Map registriert; Mausbewegung ist in Godot nicht auf +## Actions mappbar und wird deshalb direkt als InputEventMouseMotion +## gelesen, der rechte Stick direkt über die Joypad-Achsen (Deadzone 0.2). + +const WALK_SPEED := 4.0 +const SPRINT_SPEED := 7.5 +const STOP_SPEED := 16.0 +const MESH_TURN_SPEED := 10.0 +const MOUSE_SENSITIVITY := 0.003 +const STICK_LOOK_SPEED := 2.5 +const STICK_DEADZONE := 0.2 +const PITCH_MIN := -1.2 +const PITCH_MAX := 0.5 +const ZOOM_MIN := 2.0 +const ZOOM_MAX := 14.0 +const ZOOM_STEP := 0.8 +const ZOOM_BUTTON_SPEED := 8.0 +const ZOOM_SMOOTHING := 10.0 + +var _target_zoom := 9.0 +var _gravity: float = ProjectSettings.get_setting("physics/3d/default_gravity") + +@onready var _camera_pivot: Node3D = $CameraPivot +@onready var _spring_arm: SpringArm3D = $CameraPivot/SpringArm3D +@onready var _mesh: MeshInstance3D = $MeshInstance3D + + +## Fängt den Mauszeiger ein und übernimmt die im Editor gesetzte +## SpringArm-Länge als Zoom-Ziel. +func _ready() -> void: + Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED) + _target_zoom = _spring_arm.spring_length + + +## Verarbeitet Maus-Look, Mausrad-Zoom sowie das Freigeben des Cursors über +## cancel und das Wieder-Einfangen per Mausklick. +func _unhandled_input(event: InputEvent) -> void: + if event is InputEventMouseMotion and Input.get_mouse_mode() == Input.MOUSE_MODE_CAPTURED: + _rotate_camera(-event.relative.x * MOUSE_SENSITIVITY, -event.relative.y * MOUSE_SENSITIVITY) + elif event is InputEventMouseButton and event.pressed: + if event.is_action("camera_zoom_in"): + _target_zoom = clampf(_target_zoom - ZOOM_STEP, ZOOM_MIN, ZOOM_MAX) + elif event.is_action("camera_zoom_out"): + _target_zoom = clampf(_target_zoom + ZOOM_STEP, ZOOM_MIN, ZOOM_MAX) + elif Input.get_mouse_mode() != Input.MOUSE_MODE_CAPTURED: + Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED) + elif event.is_action_pressed("cancel"): + Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE) + + +## Treibt pro Physik-Tick Stick-Look, Schultertasten-Zoom, Zoom-Glättung und +## Bewegung an. +func _physics_process(delta: float) -> void: + _apply_stick_look(delta) + _apply_button_zoom(delta) + _apply_zoom_smoothing(delta) + _apply_movement(delta) + + +## Liefert die aktuelle Kamera-Distanz in Metern für das Debug-Overlay. +func get_camera_zoom() -> float: + return _spring_arm.spring_length + + +## Dreht die Kamera um yaw_delta (horizontal, am Pivot) und pitch_delta +## (vertikal, am SpringArm, begrenzt auf PITCH_MIN..PITCH_MAX). Beide Werte +## in Radiant. +func _rotate_camera(yaw_delta: float, pitch_delta: float) -> void: + _camera_pivot.rotation.y = wrapf(_camera_pivot.rotation.y + yaw_delta, -PI, PI) + _spring_arm.rotation.x = clampf(_spring_arm.rotation.x + pitch_delta, PITCH_MIN, PITCH_MAX) + + +## Liest den rechten Stick des ersten aktiven Controllers und dreht die +## Kamera zeitbasiert. +func _apply_stick_look(delta: float) -> void: + var stick := Vector2( + _read_joy_axis(JOY_AXIS_RIGHT_X), + _read_joy_axis(JOY_AXIS_RIGHT_Y) + ) + if stick != Vector2.ZERO: + _rotate_camera(-stick.x * STICK_LOOK_SPEED * delta, -stick.y * STICK_LOOK_SPEED * delta) + + +## Zoomt kontinuierlich, solange eine Schultertaste gehalten wird. +func _apply_button_zoom(delta: float) -> void: + var zoom_input := Input.get_action_strength("camera_zoom_out") - Input.get_action_strength("camera_zoom_in") + if zoom_input != 0.0: + _target_zoom = clampf(_target_zoom + zoom_input * ZOOM_BUTTON_SPEED * delta, ZOOM_MIN, ZOOM_MAX) + + +## Führt die SpringArm-Länge weich an das Zoom-Ziel heran. +func _apply_zoom_smoothing(delta: float) -> void: + _spring_arm.spring_length = lerpf(_spring_arm.spring_length, _target_zoom, minf(ZOOM_SMOOTHING * delta, 1.0)) + + +## Wendet Schwerkraft an, bewegt den Spieler kamerarelativ mit Geh- oder +## Sprint-Tempo und dreht das Kapsel-Mesh weich in Laufrichtung. +func _apply_movement(delta: float) -> void: + if not is_on_floor(): + velocity.y -= _gravity * delta + var input_dir := Input.get_vector("move_left", "move_right", "move_forward", "move_back") + var direction := _camera_pivot.global_transform.basis * Vector3(input_dir.x, 0.0, input_dir.y) + direction.y = 0.0 + var speed := SPRINT_SPEED if Input.is_action_pressed("sprint") else WALK_SPEED + if direction.length_squared() > 0.0: + velocity.x = direction.x * speed + velocity.z = direction.z * speed + var target_yaw := atan2(-direction.x, -direction.z) + _mesh.rotation.y = lerp_angle(_mesh.rotation.y, target_yaw, minf(MESH_TURN_SPEED * delta, 1.0)) + else: + velocity.x = move_toward(velocity.x, 0.0, STOP_SPEED * delta) + velocity.z = move_toward(velocity.z, 0.0, STOP_SPEED * delta) + move_and_slide() + + +## Liest eine Joypad-Achse über alle verbundenen Controller und liefert den +## ersten Wert außerhalb der Deadzone, sonst 0. +func _read_joy_axis(axis: JoyAxis) -> float: + for device in Input.get_connected_joypads(): + var value := Input.get_joy_axis(device, axis) + if absf(value) > STICK_DEADZONE: + return value + return 0.0 diff --git a/scripts/ui/.gitkeep b/scripts/ui/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/scripts/ui/debug_overlay.gd b/scripts/ui/debug_overlay.gd new file mode 100644 index 0000000..c68e2e2 --- /dev/null +++ b/scripts/ui/debug_overlay.gd @@ -0,0 +1,58 @@ +extends CanvasLayer +## Debug-Overlay für Phase 0. +## +## Zeigt FPS, das zuletzt benutzte Eingabegerät (Tastatur/Maus, Xbox- oder +## PS5-Controller), die Spielerposition und die aktuelle Kamera-Distanz an. +## Die provisorische Geräteerkennung wandert in einer späteren Phase in das +## Autoload InputPrompts (dynamische Button-Prompts, SPEC.md Abschnitt 2). + +const JOY_MOTION_THRESHOLD := 0.2 +const PLAYSTATION_NAME_HINTS: Array[String] = [ + "ps5", "ps4", "dualsense", "dualshock", "sony", "playstation", +] + +@export var player_path: NodePath + +var _active_device := "Tastatur/Maus" +var _player: CharacterBody3D + +@onready var _info_label: Label = $InfoLabel + + +## Löst die Spieler-Referenz aus dem exportierten Pfad auf. +func _ready() -> void: + _player = get_node_or_null(player_path) as CharacterBody3D + + +## Merkt sich das zuletzt benutzte Eingabegerät anhand des Event-Typs; +## Stick-Rauschen unterhalb der Deadzone wird ignoriert. +func _input(event: InputEvent) -> void: + if event is InputEventKey or event is InputEventMouseButton or event is InputEventMouseMotion: + _active_device = "Tastatur/Maus" + elif event is InputEventJoypadButton: + _active_device = _describe_joypad(event.device) + elif event is InputEventJoypadMotion and absf(event.axis_value) > JOY_MOTION_THRESHOLD: + _active_device = _describe_joypad(event.device) + + +## Baut den Anzeigetext jedes Frame neu auf. +func _process(_delta: float) -> void: + var lines := PackedStringArray() + lines.append("FPS: %d" % Engine.get_frames_per_second()) + lines.append("Eingabegerät: %s" % _active_device) + if is_instance_valid(_player): + var pos := _player.global_position + lines.append("Position: (%.1f, %.1f, %.1f)" % [pos.x, pos.y, pos.z]) + if _player.has_method("get_camera_zoom"): + lines.append("Kamera-Zoom: %.1f m" % _player.get_camera_zoom()) + _info_label.text = "\n".join(lines) + + +## Ordnet einen Controller anhand seines Gerätenamens der PS5- oder +## Xbox-Familie zu. +func _describe_joypad(device: int) -> String: + var joy_name := Input.get_joy_name(device).to_lower() + for hint in PLAYSTATION_NAME_HINTS: + if joy_name.contains(hint): + return "PS5-Controller" + return "Xbox-Controller"