From 0f4ab3d3eb4043c2a3915ee4e5c54fd887dac828 Mon Sep 17 00:00:00 2001 From: danny Date: Sun, 5 Jul 2026 00:34:06 +0200 Subject: [PATCH] CR: BG3-Chatbox fuer Dialoge + Doc-Updates (TYRVEIL.md, WELT.md) - dialogue_choices zu dialogue_box umgebaut: Panel am unteren Bildrand zeigt jede Dialog-Zeile mit Sprechernamen lesbar an, Antwortauswahl integriert; Sprechblasen bleiben als Ambiente (CHANGEREQUESTS_DONE.md) - DialogueSystem spiegelt jede Zeile in die Box, Anzeigenamen aus neuer speakers-Map der Dialog-Dateien (Fallback: grossgeschriebene ID) - Einmal-Effekt-Grundlage: GameState.completed_dialogues (gespeichert, Save/Load-fest), DialogueSystem wendet Options-Effekte nur beim ersten Durchlauf an - Doc-Updates des Users eingecheckt: TYRVEIL.md (Protagonisten-Akte), WELT.md (Buch-Kanon), ueberarbeitete STORY/CHARACTERS/SPEC, CHANGEREQUESTS-Workflow Co-Authored-By: Claude Fable 5 --- docs/CHANGEREQUESTS.md | 5 + docs/CHANGEREQUESTS_DONE.md | 21 ++ docs/CHARACTERS.md | 68 +------ docs/SPEC.md | 5 +- docs/STORY.md | 24 ++- docs/TYRVEIL.md | 131 ++++++++++++ docs/WELT.md | 190 ++++++++++++++++++ scenes/ui/dialogue_box.tscn | 51 +++++ scenes/ui/dialogue_choices.tscn | 29 --- scripts/autoloads/dialogue_system.gd | 107 +++++++--- scripts/autoloads/game_state.gd | 20 ++ scripts/ui/dialogue_box.gd | 102 ++++++++++ ...gue_choices.gd.uid => dialogue_box.gd.uid} | 0 scripts/ui/dialogue_choices.gd | 71 ------- 14 files changed, 624 insertions(+), 200 deletions(-) create mode 100644 docs/CHANGEREQUESTS.md create mode 100644 docs/CHANGEREQUESTS_DONE.md create mode 100644 docs/TYRVEIL.md create mode 100644 docs/WELT.md create mode 100644 scenes/ui/dialogue_box.tscn delete mode 100644 scenes/ui/dialogue_choices.tscn create mode 100644 scripts/ui/dialogue_box.gd rename scripts/ui/{dialogue_choices.gd.uid => dialogue_box.gd.uid} (100%) delete mode 100644 scripts/ui/dialogue_choices.gd diff --git a/docs/CHANGEREQUESTS.md b/docs/CHANGEREQUESTS.md new file mode 100644 index 0000000..e4a0650 --- /dev/null +++ b/docs/CHANGEREQUESTS.md @@ -0,0 +1,5 @@ +# CHANGEREQUESTS.md — Windgeschworen + +> Hier schreibe ich Änderungen auf die mir während dem Test auffällt. Bitte arbeite die bei jeder Phase vorher ab sodass hier alles erledifgt ist + +> Erledigte Punkte Löscht du bitte sodass diese nicht ausversehen doppelt gemacht werden. Die Erledigten Punkte sollen dann Bitte in die Datei CHANGEREQUESTS_DONE rein mit einer Anmerkung von dir wann geändert und was du getan hast. diff --git a/docs/CHANGEREQUESTS_DONE.md b/docs/CHANGEREQUESTS_DONE.md new file mode 100644 index 0000000..20f7d89 --- /dev/null +++ b/docs/CHANGEREQUESTS_DONE.md @@ -0,0 +1,21 @@ +# CHANGEREQUESTS_DONE.md — Windgeschworen + +> Abgearbeitete Change Requests aus CHANGEREQUESTS.md, mit Datum und +> Anmerkung, was geändert wurde. + +## 2026-07-05 — Chatbox statt schlecht lesbarer Sprechblasen (BG3-Stil) + +**Request:** „Die Sprechblasen sind so nicht gut lesbar. Bitte mach unten +eine Chatbox wo meine Antwort Auswahl auch steht. so wie in Baldus Gate 3 +beispielsweise." + +**Umsetzung:** Die bisherige reine Antwortauswahl (dialogue_choices) wurde +zur Dialog-Box ausgebaut (scenes/ui/dialogue_box.tscn + +scripts/ui/dialogue_box.gd): ein Panel am unteren Bildrand zeigt jede +Dialog-Zeile mit Sprechernamen gut lesbar an, die Antwortoptionen +erscheinen direkt darunter in derselben Box (fokus-navigierbar mit +Tastatur und Controller, wie zuvor). Das DialogueSystem spiegelt jede +Zeile in die Box. Die Sprechblasen über den Köpfen bleiben als Ambiente +bestehen — die Box ist die verlässlich lesbare Quelle. Falls die Blasen +ganz wegfallen sollen: kurzer Folge-Request genügt, das ist eine +Ein-Zeilen-Änderung im DialogueSystem. diff --git a/docs/CHARACTERS.md b/docs/CHARACTERS.md index 154decc..efa53c2 100644 --- a/docs/CHARACTERS.md +++ b/docs/CHARACTERS.md @@ -1,65 +1,19 @@ # CHARACTERS.md — Windgeschworen > Charakter-Bibel. Jeder Dialog muss konsistent zu diesen Stimmen sein. +> **Welt & Kanon der Bücher:** WELT.md. **Volle Akte des Protagonisten:** +> TYRVEIL.md. Die Einträge unten beschreiben die **Spiel-Stimme** der Figuren, +> nicht ihren Buch-Kanon (der steht in WELT.md — keine Doppelung). -## Tyrveil (Protagonist) +## Tyrveil Rowyth (Protagonist) +Vollständige Figuren-Akte in **TYRVEIL.md** (Vorgeschichte, Aussehen, Wesen, +Fehler, Stimme, Beziehungen, Bogen). Hier nur der Ein-Satz-Kern für schnelle +Konsistenz-Checks: -### 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 einer der ranghöchsten Offiziere der -Rebellion — ein General, nicht ihr Anführer, aber ein enger Freund von Xadens -Vater — der im Zusammenbruch seinen Posten und seine Truppe verließ, um eine -letzte Gruppe eingeschlossener Kinder zu retten. Öffentlich als Deserteur -hingerichtet, der seine Pflicht verriet und Kinder als Ausrede missbrauchte. -Als Kind mit dem Rebellen-Relikt gezeichnet → lebenslanger Verdacht, -Zwangs-Rekrutierung in den Reiterquadrant, wo man erwartet, dass Gezeichnete -sterben. Aufgewachsen im Schutz der anderen Gezeichneten — dort lernte er -beides: dass Weichheit nach außen bestraft wird, und dass seine Leute nur -einander haben. - -### Die Klinge -- 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 -- 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 -- Ü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. - -### Beziehungen -- **Imogen** — seine Partnerin. Bei ihr muss er die Wache nicht halten; - Liebe als gemeinsamer Widerstand, nicht als Zuflucht. -- **Violet** — die Freundin, mit der er rennt. Beschützt ihre Wärme wie - einen Teil von sich, den er sich weigert abzutöten. -- **Xaden** — Bruder im Kommando. Eine Nähe, die älter ist als beide - selbst, geerbt von ihren Vätern. -- **Liam** — der beste Freund unter den Erstjahren. Sticheleien und - erbitterte Schutzhaltung, ohne dass es je ausgesprochen wird. -- **Wren** — der Jüngste, den er beschützt, ohne zu wissen, dass diese - Schuld ihm bereits einmal vererbt wurde. -- **Maren** — Respekt für die, die länger durchhält als er. Ahnt nicht, - was sie über seinen Vater weiß. +Gezeichneter, Sohn des als Deserteur hingerichteten Generals Robert Rowyth; +kampfgehärtet, wortkarg, tödlich kompetent — und heimlich der, der nachts +nachsieht, ob die Jüngeren schlafen. Kern-Dualität **Klinge ↔ Herz**. Stimme: +trocken, untertrieben, Galgenhumor. ## Imogen Nach außen nur Kanten — bei Tyrveil muss sie sich nicht panzern. Liebe als diff --git a/docs/SPEC.md b/docs/SPEC.md index 081a103..45cc9cc 100644 --- a/docs/SPEC.md +++ b/docs/SPEC.md @@ -1,7 +1,8 @@ # 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. +> CHARACTERS.md, TYRVEIL.md, WELT.md, ASSETS.md) VOR jeder Aufgabe. Bei Konflikt +> gewinnt die SPEC. ## 1. Vision Third-Person-RPG im ersten Ausbildungsjahr an einer Drachenreiter-Akademie. @@ -32,7 +33,7 @@ Privates Fan-Projekt (siehe Rechtehinweis in README.md). - **Keine Inline-Kommentare.** Erlaubt: `##`-Doku-Blöcke ÜBER Funktionen und Klassen (Zweck + Parameter erklären). -## 4. Protagonist & Setup (Details: CHARACTERS.md) +## 4. Protagonist & Setup (Details: TYRVEIL.md; Welt/Kanon: WELT.md) - Tyrveil: Gezeichneter, kampfgehärteter Build (solide Kraft/Schnelligkeit, Verstand wächst übers Spiel). Kern-Dualität **Klinge ↔ Herz**. - Mit Imogen liiert (bestehende Beziehung → "Beziehung unter Druck"). diff --git a/docs/STORY.md b/docs/STORY.md index 4c575a2..06f4984 100644 --- a/docs/STORY.md +++ b/docs/STORY.md @@ -2,20 +2,21 @@ > Kanon-Quelle für alle Dialoge, Szenen und Story-Daten. Claude Code erfindet > keine Handlung über dieses Dokument hinaus. Was hier steht, ist wahr. +> **Welt & Buch-Kanon (Flammengeküsst/-getragen):** WELT.md. **Protagonist:** +> TYRVEIL.md. ## 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. +Schultern, statt nur weh zu tun. Trauer und Licht laufen ineinander. 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 +gebrandmarkt — werden in den Reiterquadrant von Basgiath 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. @@ -26,7 +27,7 @@ General der Rebellion, nicht ihr Anführer, der im Zusammenbruch seinen Posten und seine Truppe verließ, um eine letzte Gruppe Kinder zu retten. Offiziell hingerichtet als Deserteur, der seine Pflicht verriet und Kinder als Vorwand benutzte, um selbst zu fliehen. Sein Vater diente einst an der Seite von Xadens -Vater, dem Anführer der Rebellion — die beiden waren Freunde, keine bloßen +Vater Fen Riorson, dem Anführer der Rebellion — die beiden waren Freunde, keine bloßen Waffenbrüder. Diese Freundschaft ist eine Generation weitergereicht: Xadens Verantwortungsgefühl für Tyrveil ist keine reine Pflicht gegenüber einem Gezeichneten, sondern eine stille Schuld gegenüber dem Andenken seines Vaters. @@ -106,7 +107,11 @@ für spätere Phasen. gehören zu den Geretteten von damals). Beziehung unter Druck. - **Violet Sorrengail** — Verbündete und Freundin, mit der Tyrveil durch die Gegend rennt. Spiegelt die Wärme, die er sich weigert abzutöten. Fast - geschwisterlich. + geschwisterlich. Ihr kanonischer Buch-1-Bogen läuft im Hintergrund sichtbar + mit — wie in den Büchern: Bindung an **Tairn** (schwarz) UND den Federschwanz + **Andarna**, das **Blitz-Signet**, ihr Weg vom Schreiber- in den + Reiterquadrant, mit Xaden liiert. Hier ist sie aber nicht die Heldin, sondern + Tyrveils Freundin (siehe WELT.md, Abschnitt 9). - **Xaden Riorson** — Anführer der Gezeichneten. Trägt dieselbe Last wie Tyrveil. Verbündeter, kein Love Interest. Sein Vater und General Robert Rowyth waren enge Freunde, bevor die Rebellion zerbrach — Xaden wuchs mit @@ -133,7 +138,7 @@ Wren erinnert sich, *wie*. 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 +unter Druck, Ton je nach Mature-Toggle). Maren taucht als ruhige, wissende Präsenz auf und lässt Andeutungen über Tyrveils Vater fallen, die er noch nicht einordnen kann. @@ -191,5 +196,8 @@ Beats: ## 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. +- Liams Schatten: sein kanonischer Tod in der **Schlacht von Resson** am Ende + des ersten Jahres. Liegt jenseits des v1-Loops (der endet beim Flug-Teaser), + klingt aber als Fixpunkt am Horizont schon in v1 an. In v1 bleibt Liam + lebendig — den ausgespielten Verlust trägt Marens Tod. - Der Menschlichkeits-Messwert wird spielrelevant. diff --git a/docs/TYRVEIL.md b/docs/TYRVEIL.md new file mode 100644 index 0000000..575299f --- /dev/null +++ b/docs/TYRVEIL.md @@ -0,0 +1,131 @@ +# TYRVEIL.md — Tyrveil Rowyth (Protagonist) + +> Die gesammelte Figuren-Akte der Spielerfigur: Vorgeschichte, Aussehen, Wesen, +> Stimme, Beziehungen, Bogen. **CHARACTERS.md verweist hierher** und hält nur +> einen Ein-Satz-Kern — Tyrveil-Details leben ausschließlich HIER (keine +> Dopplung). Welt-/Kanon-Kontext: WELT.md. Handlung: STORY.md. +> +> Tyrveil ist eine **erfundene Figur**, eingepasst in den Kanon von Buch 1 & 2 +> (siehe WELT.md, Abschnitt 9). Wo unten Fakten über die Bücher hinausgehen, +> sind sie Erfindung dieses Projekts und dürfen frei weiterentwickelt werden — +> solange sie STORY.md nicht widersprechen. + +## Steckbrief +- **Name:** Tyrveil Rowyth +- **Alter:** 20, Erstjahr im Reiterquadrant von Basgiath. +- **Herkunft:** Tyrrendor — die Provinz, aus der die Rebellion kam. +- **Status:** Gezeichneter. Sohn von **General Robert Rowyth**, hingerichtet als + angeblicher Deserteur (die Wahrheit: STORY.md, Wahrheit 2). +- **Kern:** die Dualität **Klinge ↔ Herz** — die Achse, die das ganze Spiel + trägt (SPEC §6). +- **Selbst gewählter Auftrag:** seine Leute durch das erste Jahr bringen, vor + allem die Jüngsten. Nicht befohlen — selbst geschworen. + +## Aussehen +Gebaut vom Drill und vom Überleben, nicht für den Blick: groß, breit durch die +Schultern, sehnige statt protziger Muskeln. Er bewegt sich sparsam und leise, +den Raum immer halb im Scan — eine Ruhe, die eher nach Gefahr aussieht als nach +Frieden. + +Dunkles, praktisch kurz gehaltenes Haar. **Sturmgraue Augen**, die zu wenig +preisgeben (der stille Bezug zum Titel *Windgeschworen*). Wettergegerbte Haut, +über Handrücken und Unterarmen alte Narben von Klingen und Klettergriffen. Ein +feiner Narbenzug an der Braue zieht sein Gesicht selbst im Ruhezustand ein wenig +in die Härte. + +Über Rücken und eine Schulter zieht sich sein **Rebellen-Relikt** — groß, weil +sein Vater hochrangig war; ein dunkles, luminär schimmerndes Mal, das ihn auf +den ersten Blick als Gezeichneten ausweist und das er weder verstecken kann noch +will. Kein Zierrat, ein Brandzeichen. + +Sein Lächeln ist selten und verändert alles, wenn es kommt — deshalb ist es +wertvoll. Zu Xadens Erscheinung (schwarzhaarig, goldgesprenkelte Augen) steht er +bewusst als eigener Typ: kühler, gedämpfter, weniger Feuer, mehr Wind. + +## Vorgeschichte +Tyrveil wuchs als Sohn eines der ranghöchsten Offiziere der Rebellion auf — +General **Robert Rowyth**, kein Anführer des Aufstands, aber ein enger Freund +von **Fen Riorson**, Xadens Vater; die beiden waren Freunde, keine bloßen +Waffenbrüder. Als die Rebellion zusammenbrach, verließ Robert seinen Posten und +seine Truppe, um eine letzte Gruppe eingeschlossener Kinder herauszuholen — +darunter Imogens jüngere Geschwister und einen kleinen Jungen namens Wren. Er +kaufte ihnen mit seinem Leben die Flucht und wurde öffentlich als **Deserteur** +hingerichtet, der „Kinder als Ausrede" missbraucht habe. Die Umkehrung der +Wahrheit ist total (STORY.md, Wahrheit 2). + +Noch als Kind wurde Tyrveil mit dem **Rebellen-Relikt** gezeichnet: lebenslanger +Verdacht, überall erkannt, nirgendwo vertraut, und schließlich die +Zwangsrekrutierung in den Reiterquadrant — dorthin, wo man erwartet, dass +Gezeichnete sterben. Aufgewachsen ist er **im Schutz der anderen Gezeichneten**, +unter dem wachsamen Auge von **Xaden** und **Maren**. Dort lernte er zwei Dinge, +die sich beißen: dass Weichheit nach außen bestraft wird — und dass seine Leute +nur einander haben. + +Aus dieser Doppellehre wächst seine Lebenslüge: Er hält die Weichheit in sich +für einen **Erbfehler seines Vaters**, für genau die Schwäche, die den General +angeblich zum Verräter machte. Er verachtet an sich, was er insgeheim am meisten +schützt. Den größten Teil seiner Schuld trägt er, ohne sie zu kennen: dass sein +Vater für Wren starb — die Rettung, die ihm bereits einmal vererbt wurde, bevor +er sie ein zweites Mal selbst übernimmt. + +## Wesen / Art (Klinge ↔ Herz) +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. + +### Die Klinge +- 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 +- 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 & Bruchstellen +- Überbeschützend bis kontrollierend; zieht Risiken auf sich, die nicht seine + wären. +- 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. (Resonanz zum verdeckten Menschlichkeits-Messwert, + SPEC §6 / STORY.md §6.) + +## Stimme & Sprache +Trocken, untertrieben, spart mit Worten, bis er vertraut. Galgenhumor. Sagt viel +mit einem Blick statt mit einem Satz. Seine seltenen offenen Bekenntnisse treffen +gerade DESHALB hart. Für Dialog-Autoren: lieber ein knapper Satz mit Doppelboden +als drei erklärende; Wärme zeigt er über Taten und kleine Aufmerksamkeiten, nicht +über große Worte. + +## Beziehungen +- **Imogen** — seine Partnerin. Bei ihr muss er die Wache nicht halten; Liebe als + gemeinsamer Widerstand, nicht als Zuflucht. +- **Violet** — die Freundin, mit der er rennt. Beschützt ihre Wärme wie einen + Teil von sich, den er sich weigert abzutöten. +- **Xaden** — Bruder im Kommando. Eine Nähe, die älter ist als beide selbst, + geerbt von ihren Vätern. +- **Liam** — der beste Freund unter den Erstjahren. Sticheleien und erbitterte + Schutzhaltung, ohne dass es je ausgesprochen wird. +- **Wren** — der Jüngste, den er beschützt, ohne zu wissen, dass diese Schuld ihm + bereits einmal vererbt wurde. +- **Maren** — Respekt für die, die länger durchhält als er. Ahnt nicht, was sie + über seinen Vater weiß. + +## Rolle im Spiel / Bogen +Tyrveils äußerer Auftrag (seine Leute durchbringen) und seine innere Frage +(Klinge oder Herz?) laufen über die drei Wahrheiten zusammen: Er durchschaut die +gewollte Aussonderung (Wahrheit 1), erfährt durch Marens Tod die wahre +Geschichte seines Vaters (Wahrheit 2) und begreift beim Dreschen, dass die +Drachen die Gezeichneten *gerade wegen* ihres ungebrochenen Wesens wählen +(Wahrheit 3). Wahrheit 2 ist sein persönlicher Wendepunkt: Die Weichheit, die er +für einen Erbfehler hielt, war die einzige Pflicht, die am Ende zählte. Seine +Scham kippt in Trauer *und* Stolz — und beantwortet die Klinge-↔-Herz-Frage, die +das ganze Spiel durchzieht. Der Spieler färbt über seine Entscheidungen, wie +Tyrveil diesen Weg geht — nie als Gut/Böse, immer als zwei gültige Seiten +desselben Mannes. diff --git a/docs/WELT.md b/docs/WELT.md new file mode 100644 index 0000000..34872f0 --- /dev/null +++ b/docs/WELT.md @@ -0,0 +1,190 @@ +# WELT.md — Windgeschworen (Kanon-Referenz Buch 1 & 2) + +> Quelle: Rebecca Yarros, „Empyrean"-Reihe — Buch 1 *Fourth Wing* (dt. +> *Flammengeküsst*) und Buch 2 *Iron Flame* (dt. *Flammengetragen*). +> Diese Datei hält fest, **in welcher Welt** Windgeschworen spielt und **wer +> die Figuren der Bücher sind** — als Fundament, auf dem Tyrveils erfundene +> Geschichte (STORY.md) aufsitzt. Sie ist Nachschlagewerk, keine Handlung. +> +> ⚠️ **Spoiler bis einschließlich Buch 2.** +> Rangfolge bei Konflikten: **SPEC.md > STORY.md > diese Datei.** Wo das Spiel +> bewusst vom Kanon abweicht, steht das unter Abschnitt 9 („Verhältnis zum +> Kanon"). Erfundenes (Tyrveil, sein Vater, Wren, Maren) ist dort und in +> STORY.md als solches markiert. + +## 1. Die Reihe in einem Satz +An einer tödlichen Kriegsakademie werden junge Menschen mit Drachen verbunden, +um ein Königreich zu verteidigen, das seiner eigenen Bevölkerung die wahre +Bedrohung verschweigt — und deren Kinder, die aus einer niedergeschlagenen +Rebellion stammen, sind dazu verdammt, in diesem System zuerst zu verbrennen. + +## 2. Geografie & Mächte +- **Navarre** — das Königreich, in dem die Akademie liegt. Sicher hinter uralten + **Schutzzaubern (Wards)**, die von Drachen und Reitern gespeist werden. Nach + innen diszipliniert, militärisch, verschlossen. Lebt von einer Lebenslüge + (siehe Abschnitt 7). +- **Poromiel** — Nachbarreich im Osten, verfeindet. Seine Krieger reiten + **Greife (Gryphons)** statt Drachen. In Buch 2 kippt das Bild: Poromiel ist + weniger Feind als Leidtragender derselben verschwiegenen Bedrohung — aus + Gegnern werden mögliche Verbündete. +- **Tyrrendor** — die südliche Provinz/Herzogtum, aus der die Rebellion kam. + Heimat der Riorsons. Stolz, eigensinnig, vom Königreich beargwöhnt. +- **Aretia** — die zerstörte Rebellenstadt in Tyrrendor. In Buch 2 heimlich als + Basis des offenen Widerstands wiederaufgebaut. +- **Das Ödland / jenseits der Grenzen** — Land, das buchstäblich zu Staub + zerfällt, wo dunkle Magie die Erde leergesogen hat. Von hier kommt die wahre + Gefahr. + +## 3. Basgiath War College & die vier Quadranten +Die **Basgiath-Kriegsakademie** bildet Navarres gesamtes Militär aus, geteilt in +vier Quadranten: +- **Reiterquadrant** — Drachenreiter. Der tödlichste, angesehenste Quadrant; wer + hier scheitert, stirbt oft wörtlich. **Hier spielt Windgeschworen.** +- **Schreiberquadrant** — Chronisten, Archiv, Wissen. Verwaltet (und verbirgt) + die offizielle Geschichte. Sanftester Weg — Violet war eigentlich dafür + bestimmt. +- **Heilerquadrant** — Menderei/Heilmagie. +- **Infanteriequadrant** — Fußtruppen ohne Drachen. + +Organisation im Reiterquadrant: Kadetten stecken in **Squads**, die zu +**Sektionen** und **Flügeln (Wings)** gebündelt sind, geführt von **Squad-, +Sektions- und Wingleadern**. Drei Jahrgänge; jedes Jahr fordert Tote. + +## 4. Drachen, Bindung & Signets +- **Drachen** sind uralt, hochintelligent, sarkastisch und wählen selbst, ob und + wen sie binden. Kein Kadett zwingt einen Drachen. +- **Die Bindung** koppelt Reiter und Drache auf Leben und Tod: Stirbt der Drache, + stirbt der Reiter. Stirbt der Reiter, überlebt der Drache meist — trauernd. + Über die Bindung fließt Magie in den Reiter. +- **Signet** — die einzigartige, singuläre Kraft, die ein Reiter nach der Bindung + entwickelt; sie spiegelt sein Wesen (Violet: Blitz; Xaden: Schatten; Dain: + Erinnerungen lesen; Melgren: Kriegsausgänge vorhersehen). +- **Farben & Schwanztypen** bestimmen Temperament und Kampfrolle. Die genaue + Spiel-Tabelle steht in SPEC.md §6 — **Schwarz** ist das seltenste, mächtigste + Blut (Violets Tairn), **Federschwänze** gelten als klein und „nutzlos", sind + in Wahrheit aber etwas Besonderes. +- **Federschwanz (Andarna)** — im Kanon extrem selten, jung, unterschätzt, mit + einzigartigen Fähigkeiten. In Windgeschworen der narrative Anker für Wahrheit 3 + („erkennt ungebrochene Herzen", STORY.md, Klimax). + +## 5. Der Weg durchs erste Jahr (Rituale → Spiel-Mapping) +Die kanonischen Prüfungen des ersten Jahres, und wie das Spiel sie benennt: +- **Der Parapet** — eine schmale, hohe Steinbrücke, die Erstjahr-Kadetten am + ersten Tag überqueren müssen; wer fällt, stirbt. → In Windgeschworen als + **„Viadukt"**-Set-Piece umgesetzt (STORY.md, Prolog). +- **Der Gauntlet** — ein tödlicher Hindernis-Kletterlauf, den man bestehen muss, + um zur Bindung zugelassen zu werden. → Im Spiel manipuliert als Skill-Gate und + Wendepunkt (Marens Tod). +- **Presentation & Dreschen (Threshing)** — die Zeremonie, bei der die Drachen + aus dem Jahrgang wählen. → Klimax des Spiels; läuft über das Bindungs-RNG + (SPEC §6). +- **Kriegsspiele / Sparring** — laufende stat- und überlebensbasierte + Wettkämpfe zwischen Squads. → Phase 4 (Sparring, Jack-Barlowe-Konflikt). + +## 6. Die Rebellion & die Gezeichneten (Marked Ones) +- Gut sechs Jahre vor Buch 1 zerbrach ein **Separatisten-Aufstand**, angeführt + von **Fen Riorson**, dem Herzog von Tyrrendor (Xadens Vater). Er wurde in + Aretia niedergeschlagen; die Anführer wurden **hingerichtet**. +- Ihre Kinder — die **Gezeichneten (Marked Ones)** — tragen ein **Rebellen-Relikt**: + ein dunkles, luminär glühendes Mal auf der Haut. Seine **Größe entspricht dem + Rang des hingerichteten Elternteils** (Xadens Relikt bedeckt seinen ganzen + Rücken, weil sein Vater den Aufstand führte). +- Die Gezeichneten werden **zwangsweise in den Reiterquadrant gesteckt** und + scharf beobachtet. Offiziell Gleichbehandlung, faktisch eine stille + **Aussonderung**: Man rechnet damit, dass viele das erste Jahr nicht + überleben, und richtet die Bedingungen still darauf aus. Sie halten allein + zusammen — **Xaden** ist ihr Anführer und Schutzschild. + +## 7. Die verborgene Bedrohung (v. a. Buch 2) +- **Venin** — Menschen, die dunkle Magie direkt aus der Erde ziehen, statt aus + einem Drachen. Das saugt das Land leer und lässt es zu Staub zerfallen. Sie + sind fast unsterblich und der eigentliche Feind. +- **Wyvern** — die zweibeinigen, flügellosen, giftigen Bestien, die Venin + erschaffen und in die Schlacht führen — Drachen ohne Seele. +- **Navarres Lüge** — die Führung des Königreichs (u. a. General **Melgren** und + das herrschende Gremium) **verschweigt die Existenz der Venin** und hortet das + Wissen, wie man sich schützt. Die Wards halten Navarre sicher, während + Poromiel blutet. Genau diese Vertuschung war der wahre Kern der Rebellion: + Tyrrendor wollte warnen und schützen, nicht bloß Macht. Das ist der rote + Faden, der Windgeschworens „angelegten Haken" (STORY.md) speist. + +## 8. Kanon-Figuren (Buch 1 & 2) +Beschreibung = **wer sie in den Büchern sind**. Wie sie in *unserem* Spiel +auftreten und klingen, steht in CHARACTERS.md — dort keine Kanon-Doppelung, +sondern Spiel-Stimme. + +### Reiter & Kadetten +- **Violet Sorrengail** — Protagonistin der Bücher. Klein, körperlich + zerbrechlich (überdehnbare Gelenke), von ihrer Mutter aus dem Schreiber- in + den Reiterquadrant gezwungen. Silberhaar, brillanter Kopf, lernt mit Wissen zu + überleben, was ihr an Kraft fehlt. Bindet **zwei** Drachen (Tairn & Andarna), + Signet: **Blitz**. +- **Xaden Riorson** — Sohn Fen Riorsons, Anführer der Gezeichneten, Wingleader. + Signet: **Schatten**. Groß, vernarbt, Relikt über den ganzen Rücken. Im Kanon + Violets Liebe; später Herzog von Tyrrendor. +- **Dain Aetos** — Violets Jugendfreund, Squad Leader, Sohn eines Colonels. + Regeltreu bis zur Sturheit; sein Signet liest per Berührung Erinnerungen — was + zum Vertrauensbruch wird. Nicht böse, nur auf der anderen Seite der Linie. +- **Rhiannon Matthias** — Violets beste Freundin und Zimmergenossin; warm, loyal, + wächst in Führungsverantwortung. +- **Ridoc Gamlyn** — Squad-Kamerad, der Humor der Truppe. **Sawyer Henrick** — + Squad-Kamerad, ruhig, verlässlich; in Buch 2 schwer getroffen. +- **Imogen Cardulo** — Gezeichnete, ältere Kadettin, kompromisslos und + schlagfertig; im Kanon fürsorglich-hart gegenüber den Jüngeren (u. a. Sloane). +- **Liam Mairi** — Gezeichneter, den Xaden Violet als Freund/Beschützer an die + Seite stellt; golden, loyal, warm. **Stirbt am Ende von Buch 1 in der Schlacht + von Resson**, während er Violet schützt — einer der schmerzhaftesten Verluste + der Reihe. Seine jüngere Schwester **Sloane Mairi** taucht in Buch 2 auf. +- **Jack Barlowe** — Kadett und Violets erklärter Feind, der wiederholt versucht, + sie zu töten. In Buch 2 zu einem **Venin** geworden. (Speist die + Jack-Barlowe-Hinterhalte aus SPEC §10, Phase 4.) + +### Drachen +- **Tairn** — Violets großer schwarzer Drache; uralt, mächtig, tödlich stolz. +- **Andarna** — Violets kleiner goldener Federschwanz; jung, besonders, + unterschätzt. +- **Sgaeyl** — Xadens blauer Dolchschwanz und Tairns Gefährtin; ihr Paarband + zwingt Xaden und Violet, in Reichweite zueinander zu bleiben. + +### Führung, Familie & Schreiber +- **General Lilith Sorrengail** — Violets Mutter, eine der mächtigsten + Kommandantinnen Navarres; hart, unnahbar, Teil des Systems. +- **Mira Sorrengail** — Violets ältere Schwester, erfahrene Reiterin, beschützend. +- **Brennan Sorrengail** — Violets totgeglaubter Bruder; lebt, Mender-Signet, + einer der Köpfe des offenen Widerstands in Aretia. +- **General Melgren** — sieht Kriegsausgänge voraus; Schlüsselfigur der + Vertuschung. +- **Varrish** — sadistischer Vize-Kommandant in Buch 2, foltert Gezeichnete. +- **Markham** — Schreiber-Professor, Hüter der offiziellen Lüge. **Jesinia** — + gehörlose Schreiberin, Violets Freundin. **Nolon** — alter Heiler/Mender. + +## 9. Verhältnis zum Kanon (Windgeschworen-Abweichungen) +Windgeschworen spielt in *dieser* Welt und in Violets erstem Jahrgang, erzählt +aber eine **eigene, zusätzliche** Geschichte durch eine erfundene Reiterfigur. +Bewusste Setzungen: +- **Tyrveil Rowyth ist die Spielerfigur** — ein Gezeichneter, erfunden, in + Violets Kohorte eingefügt. Details: TYRVEIL.md. +- **General Robert Rowyth** (Tyrveils Vater), **Wren Calloran** und **Maren Vael** + sind Originalfiguren (OCs), in den Kanon eingepasst, aber nicht aus ihm. +- **Violet ist NICHT die Heldin dieser Geschichte**, sondern Tyrveils fast + geschwisterliche Freundin. Der Kanon-Fokus verschiebt sich von ihr auf ihn. +- **Xaden ist kein Love Interest der Spielerfigur**, sondern Tyrveils Bruder im + Kommando — verbunden über ihre Väter (Fen Riorson & Robert Rowyth). +- **Imogen ist Tyrveils Partnerin** — eine Setzung des Spiels, auf die + Kanon-Figur aufgesetzt. +- **Zeitrahmen:** das erste Ausbildungsjahr. Kanonische Ereignisse (u. a. Liams + Tod bei Resson, Jacks Wandlung, die volle Venin-Enthüllung) liegen als + **Schatten und Haken** im Hintergrund und werden in v1 nicht ausgespielt. +- **Kanon läuft im Hintergrund voll mit — „alles wie im Buch"** (entschieden): + - Die kanonische **Violet-↔-Xaden-Beziehung** besteht wie in den Büchern; sie + läuft im Hintergrund, berührt Tyrveils eigene Beziehung (Imogen) aber nicht. + Tyrveil bleibt Violet gegenüber geschwisterlich, Xaden gegenüber Bruder im + Kommando — kein Liebesdreieck. + - **Violets eigener Buch-1-Bogen läuft sichtbar parallel:** ihre Bindung an + **Tairn** (schwarz) UND **Andarna** (Federschwanz), ihr **Blitz-Signet**, ihr + Weg vom Schreiber- in den Reiterquadrant — als Kanon-Hintergrund neben + Tyrveils Geschichte, nicht als deren Zentrum. + - **Resson ist der Fixpunkt am Horizont:** Der v1-Loop endet vor der Schlacht + (beim Flug-Teaser, SPEC §5), aber Liams kanonischer Tod bei Resson klingt als + Schatten schon in v1 an. Liam bleibt in v1 lebendig (STORY.md / CHARACTERS.md); + den ausgespielten Verlust trägt Marens (OC) Tod. diff --git a/scenes/ui/dialogue_box.tscn b/scenes/ui/dialogue_box.tscn new file mode 100644 index 0000000..0016329 --- /dev/null +++ b/scenes/ui/dialogue_box.tscn @@ -0,0 +1,51 @@ +[gd_scene load_steps=2 format=3] + +[ext_resource type="Script" path="res://scripts/ui/dialogue_box.gd" id="1_box"] + +[node name="DialogueBox" type="CanvasLayer"] +layer = 2 +script = ExtResource("1_box") + +[node name="Root" type="Control" parent="."] +anchors_preset = 15 +anchor_right = 1.0 +anchor_bottom = 1.0 +grow_horizontal = 2 +grow_vertical = 2 +mouse_filter = 2 + +[node name="Panel" type="PanelContainer" parent="Root"] +anchor_left = 0.5 +anchor_top = 1.0 +anchor_right = 0.5 +anchor_bottom = 1.0 +offset_left = -460.0 +offset_top = -240.0 +offset_right = 460.0 +offset_bottom = -24.0 +grow_horizontal = 2 +grow_vertical = 0 + +[node name="Margin" type="MarginContainer" parent="Root/Panel"] +theme_override_constants/margin_left = 18 +theme_override_constants/margin_top = 12 +theme_override_constants/margin_right = 18 +theme_override_constants/margin_bottom = 12 + +[node name="Content" type="VBoxContainer" parent="Root/Panel/Margin"] +theme_override_constants/separation = 8 + +[node name="SpeakerLabel" type="Label" parent="Root/Panel/Margin/Content"] +theme_override_colors/font_color = Color(1, 0.85, 0.55, 1) +theme_override_font_sizes/font_size = 22 +text = "" + +[node name="LineLabel" type="Label" parent="Root/Panel/Margin/Content"] +size_flags_vertical = 3 +theme_override_font_sizes/font_size = 20 +text = "" +autowrap_mode = 3 + +[node name="OptionsBox" type="VBoxContainer" parent="Root/Panel/Margin/Content"] +visible = false +theme_override_constants/separation = 6 diff --git a/scenes/ui/dialogue_choices.tscn b/scenes/ui/dialogue_choices.tscn deleted file mode 100644 index 8d8f68e..0000000 --- a/scenes/ui/dialogue_choices.tscn +++ /dev/null @@ -1,29 +0,0 @@ -[gd_scene load_steps=2 format=3] - -[ext_resource type="Script" path="res://scripts/ui/dialogue_choices.gd" id="1_choices"] - -[node name="DialogueChoices" type="CanvasLayer"] -layer = 2 -script = ExtResource("1_choices") - -[node name="Root" type="Control" parent="."] -anchors_preset = 15 -anchor_right = 1.0 -anchor_bottom = 1.0 -grow_horizontal = 2 -grow_vertical = 2 -mouse_filter = 2 - -[node name="OptionsBox" type="VBoxContainer" parent="Root"] -anchor_left = 0.5 -anchor_top = 1.0 -anchor_right = 0.5 -anchor_bottom = 1.0 -offset_left = -320.0 -offset_top = -200.0 -offset_right = 320.0 -offset_bottom = -48.0 -grow_horizontal = 2 -grow_vertical = 0 -theme_override_constants/separation = 10 -alignment = 2 diff --git a/scripts/autoloads/dialogue_system.gd b/scripts/autoloads/dialogue_system.gd index 9743e87..f516ff7 100644 --- a/scripts/autoloads/dialogue_system.gd +++ b/scripts/autoloads/dialogue_system.gd @@ -2,24 +2,32 @@ extends Node ## Daten-getriebenes Dialog-System (Autoload, SPEC.md Abschnitte 6 und 8). ## ## Spielt verzweigte Dialogbäume aus JSON-Dateien unter data/dialogue ab. -## Sprecher-Zeilen erscheinen über der Sprechblase des jeweiligen Sprechers -## (Kind-Node "SpeechBubble"), die vom Spieler gewählte Antwort über seiner -## eigenen. Antwortoptionen laufen über die fokus-navigierbare Auswahl -## (dialogue_choices.tscn). Options-Tags verschieben die -## Klinge-↔-Herz-Achse (blade_heart) und Beziehungswerte (relationship: -## NPC-ID -> Delta). dialogue_started/dialogue_finished erlauben es, -## Spielerbewegung und UI während des Dialogs zu sperren. +## Jede Zeile erscheint gut lesbar in der Dialog-Box am unteren Bildrand +## (dialogue_box.tscn, inklusive Antwortauswahl) und zusätzlich als +## Sprechblase über dem Kopf des Sprechers (Kind-Node "SpeechBubble"); +## die gewählte Antwort läuft über Tyrveils eigene Blase. Options-Tags +## verschieben die Klinge-↔-Herz-Achse (blade_heart) und Beziehungswerte +## (relationship: NPC-ID -> Delta) — aber nur beim ERSTEN Durchlauf eines +## Dialogs: Abgeschlossene Dialoge merkt sich GameState.completed_dialogues +## (dort statt im StorySystem, weil nur GameState bereits gespeichert und +## geladen wird und das Flag Save/Load überleben muss). Wiederholtes +## Ansprechen spielt den Text erneut ab, ohne Werte zu verschieben. +## dialogue_started/dialogue_finished erlauben es, Spielerbewegung und UI +## während des Dialogs zu sperren. signal dialogue_started(dialogue_id: String) signal dialogue_finished(dialogue_id: String) -const CHOICES_SCENE := preload("res://scenes/ui/dialogue_choices.tscn") +const BOX_SCENE := preload("res://scenes/ui/dialogue_box.tscn") const PLAYER_SPEAKER_ID := "player" +const FALLBACK_LINE_SECONDS := 2.5 var is_dialogue_active := false var _speakers: Dictionary = {} -var _choices: CanvasLayer +var _speaker_names: Dictionary = {} +var _is_effect_pass := true +var _box: CanvasLayer ## Startet einen Dialog aus einer JSON-Datei. speakers bildet Sprecher-IDs @@ -32,9 +40,12 @@ func start_dialogue(dialogue_path: String, speakers: Dictionary) -> void: var data := _load_dialogue(dialogue_path) if data.is_empty(): return + var dialogue_id := str(data["id"]) _speakers = speakers + _speaker_names = data.get("speakers", {}) + _is_effect_pass = not GameState.has_completed_dialogue(dialogue_id) is_dialogue_active = true - dialogue_started.emit(str(data["id"])) + dialogue_started.emit(dialogue_id) _run_dialogue(data) @@ -52,54 +63,74 @@ func _load_dialogue(dialogue_path: String) -> Dictionary: return parsed -## Spielt den Dialogbaum als Coroutine ab: Zeilen über die Sprechblasen, -## Entscheidungen über die Antwortauswahl, Effekte über die Options-Tags. +## Spielt den Dialogbaum als Coroutine ab: Zeilen über Box und +## Sprechblasen, Entscheidungen über die Auswahl in der Box, Effekte über +## die Options-Tags des ersten Durchlaufs. func _run_dialogue(data: Dictionary) -> void: var nodes: Dictionary = data["nodes"] var node_id := str(data["start"]) while node_id != "" and nodes.has(node_id): var node: Dictionary = nodes[node_id] - var bubble := _bubble_for(str(node.get("speaker", ""))) var options: Array = node.get("options", []) if options.is_empty(): - node_id = await _play_line(bubble, node) + node_id = await _play_line(node) else: - node_id = await _play_choice(bubble, node, options) + node_id = await _play_choice(node, options) _end_dialogue(str(data["id"])) -## Zeigt eine Zeile ohne Optionen und liefert die ID des Folge-Knotens. -func _play_line(bubble: Node, node: Dictionary) -> String: +## Zeigt eine Zeile ohne Optionen in Box und Sprechblase; die Blase (oder +## ein Fallback-Timer) bestimmt die Anzeigedauer. Liefert die ID des +## Folge-Knotens. +func _play_line(node: Dictionary) -> String: + var speaker_id := str(node.get("speaker", "")) + var text := str(node.get("text", "")) + _get_box().show_line(_display_name(speaker_id), text) + var bubble := _bubble_for(speaker_id) if bubble != null: - bubble.show_line(str(node.get("text", ""))) + bubble.show_line(text) await bubble.line_finished + else: + await get_tree().create_timer(FALLBACK_LINE_SECONDS).timeout return _next_id(node) -## Zeigt eine Zeile mit Antwortoptionen, wendet die Tags der gewählten -## Option an, spielt die Antwort über der Spieler-Sprechblase und liefert +## Zeigt eine Zeile mit Antwortoptionen in Box (mit Auswahl) und +## Sprechblase (sticky), wendet beim ersten Durchlauf die Tags der +## gewählten Option an, spielt die Antwort über Tyrveils Blase und liefert ## die ID des Folge-Knotens. -func _play_choice(bubble: Node, node: Dictionary, options: Array) -> String: +func _play_choice(node: Dictionary, options: Array) -> String: + var speaker_id := str(node.get("speaker", "")) + var text := str(node.get("text", "")) + _get_box().show_line(_display_name(speaker_id), text) + var bubble := _bubble_for(speaker_id) if bubble != null: - bubble.show_line(str(node.get("text", "")), true) + bubble.show_line(text, true) var option_texts: Array[String] = [] for option in options: option_texts.append(str(option.get("text", ""))) - var index: int = await _get_choices().choose(option_texts) + var index: int = await _get_box().choose(option_texts) if bubble != null: bubble.hide_bubble() var option: Dictionary = options[clampi(index, 0, options.size() - 1)] _apply_option_effects(option) + var answer := str(option.get("text", "")) + _get_box().show_line(_display_name(PLAYER_SPEAKER_ID), answer) var player_bubble := _bubble_for(PLAYER_SPEAKER_ID) if player_bubble != null: - player_bubble.show_line(str(option.get("text", ""))) + player_bubble.show_line(answer) await player_bubble.line_finished + else: + await get_tree().create_timer(FALLBACK_LINE_SECONDS).timeout return _next_id(option) -## Wendet die Effekt-Tags einer Option an: blade_heart verschiebt die -## Klinge-↔-Herz-Achse, relationship verschiebt Beziehungswerte pro NPC. +## Wendet die Effekt-Tags einer Option an — nur beim ersten Durchlauf des +## Dialogs: blade_heart verschiebt die Klinge-↔-Herz-Achse, relationship +## verschiebt Beziehungswerte pro NPC. func _apply_option_effects(option: Dictionary) -> void: + if not _is_effect_pass: + return var tone_shift := int(option.get("blade_heart", 0)) if tone_shift != 0: GameState.shift_blade_heart_tone(tone_shift) @@ -108,10 +139,14 @@ func _apply_option_effects(option: Dictionary) -> void: RelationshipSystem.adjust_relationship(str(npc_id), int(relationship_shifts[npc_id])) -## Beendet den Dialog und gibt die Sprecher-Referenzen frei. +## Beendet den Dialog, markiert ihn als geführt und gibt Box und +## Sprecher-Referenzen frei. func _end_dialogue(dialogue_id: String) -> void: + GameState.mark_dialogue_completed(dialogue_id) + _get_box().hide_box() is_dialogue_active = false _speakers.clear() + _speaker_names.clear() dialogue_finished.emit(dialogue_id) @@ -128,6 +163,12 @@ func _bubble_for(speaker_id: String) -> Node: return bubble +## Liefert den Anzeigenamen eines Sprechers aus der speakers-Map der +## Dialog-Datei, sonst die großgeschriebene Sprecher-ID. +func _display_name(speaker_id: String) -> String: + return str(_speaker_names.get(speaker_id, speaker_id.capitalize())) + + ## Liefert die ID des Folge-Knotens aus einem Knoten oder einer Option; ## leerer String beendet den Dialog (auch bei JSON-null). func _next_id(source: Dictionary) -> String: @@ -135,9 +176,9 @@ func _next_id(source: Dictionary) -> String: return next if next is String else "" -## Instanziiert die Antwortauswahl beim ersten Bedarf. -func _get_choices() -> CanvasLayer: - if _choices == null: - _choices = CHOICES_SCENE.instantiate() - add_child(_choices) - return _choices +## Instanziiert die Dialog-Box beim ersten Bedarf. +func _get_box() -> CanvasLayer: + if _box == null: + _box = BOX_SCENE.instantiate() + add_child(_box) + return _box diff --git a/scripts/autoloads/game_state.gd b/scripts/autoloads/game_state.gd index 9535fcd..ac1a4a0 100644 --- a/scripts/autoloads/game_state.gd +++ b/scripts/autoloads/game_state.gd @@ -30,6 +30,7 @@ var intellect := DEFAULT_INTELLECT var blade_heart_tone := 0 var humanity := 0 var relationships: Dictionary = {} +var completed_dialogues: Dictionary = {} var is_permadeath_enabled := true @@ -41,6 +42,7 @@ func reset() -> void: blade_heart_tone = 0 humanity = 0 relationships.clear() + completed_dialogues.clear() is_permadeath_enabled = true blade_heart_tone_changed.emit(blade_heart_tone) @@ -95,6 +97,19 @@ func adjust_relationship(npc_id: String, amount: int) -> void: set_relationship(npc_id, get_relationship(npc_id) + amount) +## Markiert einen Dialog als bereits geführt. Liegt hier statt im +## StorySystem, weil GameState das einzige gespeicherte Autoload ist und +## das Flag Save/Load überleben muss (sonst ließen sich Dialog-Effekte +## durch Neuladen erneut abgreifen). +func mark_dialogue_completed(dialogue_id: String) -> void: + completed_dialogues[dialogue_id] = true + + +## Gibt zurück, ob ein Dialog bereits vollständig geführt wurde. +func has_completed_dialogue(dialogue_id: String) -> bool: + return completed_dialogues.get(dialogue_id, false) + + ## Serialisiert den kompletten Zustand als Dictionary für das SaveSystem. func to_save_dict() -> Dictionary: return { @@ -104,6 +119,7 @@ func to_save_dict() -> Dictionary: "blade_heart_tone": blade_heart_tone, "humanity": humanity, "relationships": relationships.duplicate(), + "completed_dialogues": completed_dialogues.duplicate(), "is_permadeath_enabled": is_permadeath_enabled, } @@ -123,6 +139,10 @@ func apply_save_dict(data: Dictionary) -> void: var saved_relationships: Dictionary = data.get("relationships", {}) for npc_id in saved_relationships: relationships[String(npc_id)] = clampi(int(saved_relationships[npc_id]), RELATIONSHIP_MIN, RELATIONSHIP_MAX) + completed_dialogues.clear() + var saved_dialogues: Dictionary = data.get("completed_dialogues", {}) + for dialogue_id in saved_dialogues: + completed_dialogues[String(dialogue_id)] = bool(saved_dialogues[dialogue_id]) blade_heart_tone_changed.emit(blade_heart_tone) for npc_id in relationships: relationship_changed.emit(npc_id, relationships[npc_id]) diff --git a/scripts/ui/dialogue_box.gd b/scripts/ui/dialogue_box.gd new file mode 100644 index 0000000..d42aadb --- /dev/null +++ b/scripts/ui/dialogue_box.gd @@ -0,0 +1,102 @@ +extends CanvasLayer +## Dialog-Box am unteren Bildrand im Stil von Baldur's Gate 3 +## (Change Request, siehe docs/CHANGEREQUESTS_DONE.md). +## +## Zeigt jede Dialog-Zeile gut lesbar mit Sprechernamen an und beherbergt +## die fokus-navigierbare Antwortauswahl; die Sprechblasen über den Köpfen +## bleiben als Ambiente bestehen. Navigation über Pfeiltasten/D-Pad/linken +## Stick, Aktivierung über confirm (Enter/Ⓐ/✕) nach dem Muster des +## Hauptmenü-Fixes: Events, die auch Godots ui_accept matchen, verarbeitet +## der fokussierte Button selbst, nur die übrigen (Controller) lösen +## manuell aus. choose() liefert den Index der gewählten Option als +## Coroutine. + +signal option_chosen(index: int) + +@onready var _speaker_label: Label = $Root/Panel/Margin/Content/SpeakerLabel +@onready var _line_label: Label = $Root/Panel/Margin/Content/LineLabel +@onready var _options_box: VBoxContainer = $Root/Panel/Margin/Content/OptionsBox + + +## Startet unsichtbar; sichtbar wird die Box über show_line(). +func _ready() -> void: + visible = false + + +## Zeigt eine Dialog-Zeile mit Sprechernamen; eine noch offene +## Antwortauswahl wird dabei geleert. +func show_line(speaker_name: String, text: String) -> void: + _speaker_label.text = speaker_name + _line_label.text = text + _clear_options() + visible = true + + +## Zeigt die Antwortoptionen unterhalb der aktuellen Zeile an und liefert +## den Index der gewählten Option, sobald der Spieler bestätigt hat. +func choose(option_texts: Array) -> int: + _show_options(option_texts) + var index: int = await option_chosen + return index + + +## Blendet die Box am Dialogende aus. +func hide_box() -> void: + _clear_options() + visible = false + + +## Meldet, ob gerade eine Antwortauswahl offen ist (auch für Test-Sonden). +func has_open_options() -> bool: + return visible and _options_box.visible + + +## Aktiviert mit confirm den fokussierten Options-Button (nur solange eine +## Auswahl offen ist); Fokus-Verlust wird auf die erste Option repariert. +func _unhandled_input(event: InputEvent) -> void: + if not has_open_options(): + return + if not event.is_action_pressed("confirm"): + return + var focused := get_viewport().gui_get_focus_owner() + if focused == null or focused.get_parent() != _options_box: + if _options_box.get_child_count() > 0: + (_options_box.get_child(0) as Button).grab_focus() + return + if event.is_action("ui_accept"): + return + var button := focused as BaseButton + if button != null and not button.disabled: + button.pressed.emit() + + +## Baut die Options-Buttons neu auf und setzt den Fokus auf die erste +## Option. +func _show_options(option_texts: Array) -> void: + _clear_options() + var first_button: Button = null + for i in option_texts.size(): + var button := Button.new() + button.text = str(option_texts[i]) + button.custom_minimum_size = Vector2(0, 40) + button.pressed.connect(_on_option_pressed.bind(i)) + _options_box.add_child(button) + if first_button == null: + first_button = button + _options_box.visible = true + if first_button != null: + first_button.grab_focus.call_deferred() + + +## Entfernt alle Options-Buttons und blendet die Options-Leiste aus. +func _clear_options() -> void: + for child in _options_box.get_children(): + _options_box.remove_child(child) + child.queue_free() + _options_box.visible = false + + +## Schließt die Auswahl und meldet den gewählten Index. +func _on_option_pressed(index: int) -> void: + _clear_options() + option_chosen.emit(index) diff --git a/scripts/ui/dialogue_choices.gd.uid b/scripts/ui/dialogue_box.gd.uid similarity index 100% rename from scripts/ui/dialogue_choices.gd.uid rename to scripts/ui/dialogue_box.gd.uid diff --git a/scripts/ui/dialogue_choices.gd b/scripts/ui/dialogue_choices.gd deleted file mode 100644 index 212f848..0000000 --- a/scripts/ui/dialogue_choices.gd +++ /dev/null @@ -1,71 +0,0 @@ -extends CanvasLayer -## Fokus-navigierbare Antwortauswahl für Dialoge (Phase 2a). -## -## Baut zur Laufzeit Buttons für die Antwortoptionen eines Dialog-Knotens -## auf, unten mittig im Bild. Navigation über Pfeiltasten/D-Pad/linken -## Stick, Aktivierung über confirm (Enter/Ⓐ/✕) — nach demselben Muster wie -## im Hauptmenü: Events, die auch Godots ui_accept matchen, verarbeitet der -## fokussierte Button selbst, nur die restlichen (Controller) lösen manuell -## aus. choose() liefert den Index der gewählten Option als Coroutine. - -signal option_chosen(index: int) - -@onready var _options_box: VBoxContainer = $Root/OptionsBox - - -## Startet unsichtbar; sichtbar wird die Auswahl nur über choose(). -func _ready() -> void: - visible = false - - -## Zeigt die Optionen an und liefert den Index der gewählten Option, -## sobald der Spieler bestätigt hat. -func choose(option_texts: Array) -> int: - _show_options(option_texts) - var index: int = await option_chosen - return index - - -## Aktiviert mit confirm den fokussierten Options-Button (nur solange die -## Auswahl sichtbar ist); Fokus-Verlust wird auf die erste Option repariert. -func _unhandled_input(event: InputEvent) -> void: - if not visible: - return - if not event.is_action_pressed("confirm"): - return - var focused := get_viewport().gui_get_focus_owner() - if focused == null or focused.get_parent() != _options_box: - if _options_box.get_child_count() > 0: - (_options_box.get_child(0) as Button).grab_focus() - return - if event.is_action("ui_accept"): - return - var button := focused as BaseButton - if button != null and not button.disabled: - button.pressed.emit() - - -## Baut die Options-Buttons neu auf und setzt den Fokus auf die erste -## Option. -func _show_options(option_texts: Array) -> void: - for child in _options_box.get_children(): - _options_box.remove_child(child) - child.queue_free() - var first_button: Button = null - for i in option_texts.size(): - var button := Button.new() - button.text = str(option_texts[i]) - button.custom_minimum_size = Vector2(620, 44) - button.pressed.connect(_on_option_pressed.bind(i)) - _options_box.add_child(button) - if first_button == null: - first_button = button - visible = true - if first_button != null: - first_button.grab_focus.call_deferred() - - -## Schließt die Auswahl und meldet den gewählten Index. -func _on_option_pressed(index: int) -> void: - visible = false - option_chosen.emit(index)