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 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-04 14:56:00 +02:00
commit f4c67ceead
40 changed files with 1064 additions and 0 deletions

7
.gitattributes vendored Normal file
View file

@ -0,0 +1,7 @@
* text=auto eol=lf
*.png binary
*.jpg binary
*.glb binary
*.fbx binary
*.ogg binary
*.wav binary

17
.gitignore vendored Normal file
View file

@ -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

27
README.md Normal file
View file

@ -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`.

0
assets/.gitkeep Normal file
View file

0
assets/audio/.gitkeep Normal file
View file

0
assets/models/.gitkeep Normal file
View file

0
assets/ui/.gitkeep Normal file
View file

0
data/.gitkeep Normal file
View file

0
data/dialogue/.gitkeep Normal file
View file

0
data/dragons/.gitkeep Normal file
View file

0
data/signets/.gitkeep Normal file
View file

0
data/story/.gitkeep Normal file
View file

0
docs/.gitkeep Normal file
View file

51
docs/ASSETS.md Normal file
View file

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

87
docs/CHARACTERS.md Normal file
View file

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

121
docs/SPEC.md Normal file
View file

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

156
docs/STORY.md Normal file
View file

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

114
project.godot Normal file
View file

@ -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)
]
}

0
prompts/.gitkeep Normal file
View file

5
prompts/README.md Normal file
View file

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

46
prompts/phase-0.md Normal file
View file

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

0
scenes/.gitkeep Normal file
View file

164
scenes/test_ground.tscn Normal file
View file

@ -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

0
scripts/.gitkeep Normal file
View file

View file

View file

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

View file

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

View file

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

View file

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

View file

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

View file

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

View file

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

View file

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

View file

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

View file

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

View file

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

View file

130
scripts/gameplay/player.gd Normal file
View file

@ -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

0
scripts/ui/.gitkeep Normal file
View file

View file

@ -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"