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:
commit
f4c67ceead
40 changed files with 1064 additions and 0 deletions
7
.gitattributes
vendored
Normal file
7
.gitattributes
vendored
Normal 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
17
.gitignore
vendored
Normal 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
27
README.md
Normal 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
0
assets/.gitkeep
Normal file
0
assets/audio/.gitkeep
Normal file
0
assets/audio/.gitkeep
Normal file
0
assets/models/.gitkeep
Normal file
0
assets/models/.gitkeep
Normal file
0
assets/ui/.gitkeep
Normal file
0
assets/ui/.gitkeep
Normal file
0
data/.gitkeep
Normal file
0
data/.gitkeep
Normal file
0
data/dialogue/.gitkeep
Normal file
0
data/dialogue/.gitkeep
Normal file
0
data/dragons/.gitkeep
Normal file
0
data/dragons/.gitkeep
Normal file
0
data/signets/.gitkeep
Normal file
0
data/signets/.gitkeep
Normal file
0
data/story/.gitkeep
Normal file
0
data/story/.gitkeep
Normal file
0
docs/.gitkeep
Normal file
0
docs/.gitkeep
Normal file
51
docs/ASSETS.md
Normal file
51
docs/ASSETS.md
Normal 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
87
docs/CHARACTERS.md
Normal 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
121
docs/SPEC.md
Normal 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
156
docs/STORY.md
Normal 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
114
project.godot
Normal 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
0
prompts/.gitkeep
Normal file
5
prompts/README.md
Normal file
5
prompts/README.md
Normal 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
46
prompts/phase-0.md
Normal 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
0
scenes/.gitkeep
Normal file
164
scenes/test_ground.tscn
Normal file
164
scenes/test_ground.tscn
Normal 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
0
scripts/.gitkeep
Normal file
0
scripts/autoloads/.gitkeep
Normal file
0
scripts/autoloads/.gitkeep
Normal file
7
scripts/autoloads/dialogue_system.gd
Normal file
7
scripts/autoloads/dialogue_system.gd
Normal 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.
|
||||
10
scripts/autoloads/dragon_bond_system.gd
Normal file
10
scripts/autoloads/dragon_bond_system.gd
Normal 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.
|
||||
7
scripts/autoloads/faction_system.gd
Normal file
7
scripts/autoloads/faction_system.gd
Normal 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.
|
||||
7
scripts/autoloads/game_state.gd
Normal file
7
scripts/autoloads/game_state.gd
Normal 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.
|
||||
8
scripts/autoloads/input_prompts.gd
Normal file
8
scripts/autoloads/input_prompts.gd
Normal 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.
|
||||
8
scripts/autoloads/mature_content_gate.gd
Normal file
8
scripts/autoloads/mature_content_gate.gd
Normal 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.
|
||||
7
scripts/autoloads/relationship_system.gd
Normal file
7
scripts/autoloads/relationship_system.gd
Normal 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.
|
||||
7
scripts/autoloads/save_system.gd
Normal file
7
scripts/autoloads/save_system.gd
Normal 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.
|
||||
6
scripts/autoloads/signet_system.gd
Normal file
6
scripts/autoloads/signet_system.gd
Normal 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.
|
||||
8
scripts/autoloads/story_system.gd
Normal file
8
scripts/autoloads/story_system.gd
Normal 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.
|
||||
6
scripts/autoloads/time_system.gd
Normal file
6
scripts/autoloads/time_system.gd
Normal 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.
|
||||
0
scripts/gameplay/.gitkeep
Normal file
0
scripts/gameplay/.gitkeep
Normal file
130
scripts/gameplay/player.gd
Normal file
130
scripts/gameplay/player.gd
Normal 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
0
scripts/ui/.gitkeep
Normal file
58
scripts/ui/debug_overlay.gd
Normal file
58
scripts/ui/debug_overlay.gd
Normal 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"
|
||||
Loading…
Add table
Add a link
Reference in a new issue