diff --git a/data/dialogue/akt3_k3_smaladh.json b/data/dialogue/akt3_k3_smaladh.json index 3944f0b..dc3372d 100644 --- a/data/dialogue/akt3_k3_smaladh.json +++ b/data/dialogue/akt3_k3_smaladh.json @@ -151,6 +151,7 @@ }, { "text": "Der Brief ist weg.", + "requires_flag": "coran_brief", "blade_heart": 3, "story_flag": { "brief_verbrannt": true diff --git a/data/dialogue/akt3_k5_abschied.json b/data/dialogue/akt3_k5_abschied.json index a3c2b74..f70cc2d 100644 --- a/data/dialogue/akt3_k5_abschied.json +++ b/data/dialogue/akt3_k5_abschied.json @@ -58,6 +58,7 @@ }, { "text": "Frag mich nächste Woche noch mal.", + "requires_flag": "resson_rowdy", "blade_heart": 4, "story_flag": { "rowdy_zurueckgegeben": true diff --git a/docs/CHANGEREQUESTS.md b/docs/CHANGEREQUESTS.md index c955f40..b17a3af 100644 --- a/docs/CHANGEREQUESTS.md +++ b/docs/CHANGEREQUESTS.md @@ -6,56 +6,6 @@ --- -# CR 43 — Dialog-Tags implementieren, die es nur im JSON gibt - -> **Der größte offene Posten des Projekts** (Karsten, 2026-08-23, gemessen statt -> geschätzt). Vier Tags werden von Autorenseite seit Akt 2 durchgängig benutzt und -> von `scripts/systems/dialogue_system.gd` **stillschweigend ignoriert**. Sie -> werfen keinen Fehler — sie tun einfach nichts. - -## Befund (gezählt über alle 107 Dialogdateien) - -| Tag | Vorkommen | Was es tun soll | Status | -|---|---|---|---| -| `bond` | **64×** (Option) | Drachenbindung verschieben, analog zu `relationship` | fehlt komplett | -| `requires_flag` | **13×** (Option) | Option ausblenden, solange das Flag fehlt | fehlt komplett | -| `time_card` | **15 Dateien** (Kopf) | Titelkarte vor der Szene — ersetzt den Erzähler bei Zeitsprüngen (CR 37) | fehlt komplett | -| `signet_lines` | **3×** (Knoten) | Zeile je gewürfelter Siegelkraft | fehlt komplett | - -`_regie` und `_entwurf` sind **korrekt** unimplementiert — reine Autorenfelder. -**Sie dürfen nie im Spiel erscheinen.** Bitte einen Test dazu. - -## Soll -- `bond`: wie `relationship`, aber auf die Drachenbindung. Braucht einen Zielwert - im `GameState` bzw. ein `BondSystem` analog zu `RelationshipSystem`. -- `requires_flag`: Option wird **nicht angezeigt**, wenn das Flag fehlt oder - falsch ist. Kein Ausgrauen — weg. -- `time_card`: Vollbild-Titelkarte vor dem ersten Knoten, überspringbar. -- `signet_lines`: Auswahl der Zeile anhand von Tyrveils gewürfelter Erstkraft. - -## Warum `requires_flag` zuerst kommt -Ohne dieses Tag **behauptet das Spiel Erinnerungen, die der Spieler nie hatte.** -Die sechs Stellen in Akt 3: - -| Datei / Knoten | Braucht | Sonst | -|---|---|---| -| `akt3_k2_bodhi` / `eimer_abstellen` | `resson_wasser_geholt` | Er stellt einen Eimer ab, den er nie hatte | -| `akt3_k2_bodhi` / `der_umschlag` | `coran_brief` | Er greift nach einem Brief, den er abgegeben hat | -| `akt3_k3_dorf` / `die_kiste` | `lieferung_erste_done` | Er erkennt Garricks Knoten an einer Kiste, die er nie brachte | -| `akt3_k3_smaladh` / `smaladh_brief` | `coran_brief` | dito | -| `akt3_k5_abschied` / `bodhi_naechste_woche` | `resson_rowdy` | Er gibt einen Satz zurück, der nie fiel | -| `akt3_k3_kinder` / `das_dritte_haus` | `kinder_gerufen` | kosmetisch, unkritisch | - -**Bis das Tag existiert, müssen diese Optionen abgeschaltet statt falsch gespielt -werden.** - -## Akzeptanz -- Alle vier Tags wirken; ein Testdialog deckt jeden ab. -- Kein `_regie`/`_entwurf`-Text erscheint je im Spiel (automatisierter Test). -- Die 64 `bond`-Werte landen messbar irgendwo. - ---- - # CR 44 — Akt 3 K1: Eingabe im Manifestations-Moment hart sperren > Klein, billig, und die gesamte Schuld-Konstruktion von Akt 3 hängt daran diff --git a/docs/CHANGEREQUESTS_DONE.md b/docs/CHANGEREQUESTS_DONE.md index 70e0041..28991fe 100644 --- a/docs/CHANGEREQUESTS_DONE.md +++ b/docs/CHANGEREQUESTS_DONE.md @@ -3,6 +3,60 @@ > Abgearbeitete Change Requests aus CHANGEREQUESTS.md, mit Datum und > Anmerkung, was geändert wurde. +## 2026-08-30 — CR 43: Die vier Autoren-Tags implementiert + +Alle vier Tags, die die Dialogdateien seit Akt 2 benutzen und die das +DialogueSystem stillschweigend ignoriert hat, wirken jetzt. + +- **`requires_flag`** (Option, 13× vorhanden): neu `_available_options()` — + Optionen mit dem Tag erscheinen nur bei gesetztem Story-Flag, sonst werden + sie **ausgeblendet** (kein Ausgrauen). Bleibt keine Option übrig, läuft der + Knoten als reine Zeile weiter und folgt seinem `next` — sonst hinge z. B. + `akt2_k4_erwachen/t_variante` (beide Varianten flag-gebunden) in einer + leeren Auswahl. +- **`bond`** (Option, 64×): neu `GameState.bond_level` (−100..100, Signal + `bond_level_changed`, save-persistent) mit der Fassade + `DragonBondSystem.get_bond()/adjust_bond()/set_bond()` — analog zu + RelationshipSystem. Die 64 Werte landen damit messbar im Spielstand. +- **`time_card`** (Dateikopf, 15 Dateien): Vollbild-Titelkarte vor dem ersten + Knoten, weiches Auf-/Abblenden, per confirm/interact überspringbar — + ersetzt den abgeschafften Erzähler bei Zeitsprüngen (CR 37). +- **`signet_lines`** (Knoten, 3×): `_node_text()` wählt die Zeile zu Tyrveils + gewürfelter Erstkraft (`SignetSystem.get_first_signet()`), Rückfall auf den + `default`-Eintrag. Greift direkt in CR 35. +- **`_regie`/`_entwurf`** bleiben unimplementiert. Automatisierter Test: + Kein Spiel-Skript unter `scripts/` liest diese Felder — sie können nie im + Spiel erscheinen. + +### Befund zu den „sechs Akt-3-Stellen" der CR (wichtig für den Akt-3-Bau) +Die CR-Tabelle listet sechs Stellen. Im Code sind es **zwei verschiedene +Sorten**, nur die erste ließ sich mit dem Tag lösen: + +- **2 echte Options-Fälle** — hier behauptet eine *Spielerzeile* eine + Erinnerung. Tag gesetzt (die einzigen Datenänderungen dieser CR): + - `akt3_k3_smaladh/nichts_mehr_da` → „Der Brief ist weg." braucht + `coran_brief` + - `akt3_k5_abschied/bodhi` → „Frag mich nächste Woche noch mal." braucht + `resson_rowdy` + In beiden Knoten bleiben danach zwei Optionen übrig, keine Sackgasse. +- **4 Fälle sind gar keine Optionen**, sondern **wortlose Knoten** + (`"text": "..."`), deren `_regie` eine *bedingte Inszenierung* beschreibt + (`akt3_k2_bodhi/eimer_abstellen`, `.../der_umschlag`, + `akt3_k3_dorf/die_kiste`, `akt3_k3_kinder/das_dritte_haus` — z. B. „Falls + `resson_wasser_geholt`: Er hat den Eimer noch in der Hand"). Da `_regie` + nie im Spiel erscheint und die Knoten keinen Text sprechen, **behauptet + heute nichts Falsches** — die Bedingung gehört in den Szenen-Bau + (Inszenierung), nicht in ein Options-Tag. **Offen für den Akt-3-Bau.** + +Alle fünf betroffenen Flags werden anderswo tatsächlich gesetzt +(`coran_brief`, `resson_rowdy`, `resson_wasser_geholt`, +`lieferung_erste_done`, `kinder_gerufen`) — die Gates sind also erreichbar. + +Verifikation: Headless-Probe 19/19 auf einem Testdialog mit allen vier Tags +(inkl. Klemmung, Save-Persistenz, Skip der Titelkarte, Leer-Auswahl-Fall) + +Realdaten-Probe 10/10 (beide Akt-3-Gates an/aus, Tag-Zählungen 15/15/64, +alle 107 Dialogdateien parsen), Boot-Check 7 Szenen 0 Fehler. + ## 2026-08-30 — CR 35: Siegelkraft-Reveal vom Dreschen nach Akt 2 (K2) Tyrveils erste, offensive Siegelkraft manifestiert sich nicht mehr beim diff --git a/scripts/autoloads/dialogue_system.gd b/scripts/autoloads/dialogue_system.gd index 006bf5e..35df740 100644 --- a/scripts/autoloads/dialogue_system.gd +++ b/scripts/autoloads/dialogue_system.gd @@ -31,6 +31,23 @@ extends Node ## Erst-Durchlauf-Effekt erhalten, ohne dass Abbrechen zum Werte-Farming ## taugt. dialogue_started/dialogue_finished erlauben es, Spielerbewegung ## und UI während des Dialogs zu sperren. +## +## **Autoren-Tags (CR 43)** — vier Felder, die die Dialogdateien seit Akt 2 +## durchgängig benutzen: +## - `requires_flag` (Option): Die Option erscheint nur, wenn das genannte +## Story-Flag gesetzt ist — sonst wird sie **ausgeblendet**, nicht +## ausgegraut. Verhindert, dass das Spiel Erinnerungen behauptet, die der +## Spieler nie hatte. +## - `bond` (Option): verschiebt die Drachenbindung, analog zu +## `relationship`, über DragonBondSystem.adjust_bond(). +## - `time_card` (Dateikopf): Vollbild-Titelkarte vor dem ersten Knoten, +## überspringbar — ersetzt den abgeschafften Erzähler bei Zeitsprüngen +## (CR 37). +## - `signet_lines` (Knoten): Zeilen-Tabelle je Signet-ID; gewählt wird die +## Zeile zu Tyrveils gewürfelter Erstkraft, Rückfall auf "default". +## +## `_regie` und `_entwurf` sind **reine Autorenfelder** und werden hier +## bewusst NIE gelesen — sie dürfen nie im Spiel erscheinen. signal dialogue_started(dialogue_id: String) signal dialogue_finished(dialogue_id: String) @@ -39,6 +56,8 @@ const BOX_SCENE := preload("res://scenes/ui/dialogue_box.tscn") const PLAYER_SPEAKER_ID := "player" const FALLBACK_LINE_SECONDS := 2.5 const DEFAULT_ABORT_LINE := "Nicht jetzt. Wir reden später weiter." +const TIME_CARD_SECONDS := 2.6 +const TIME_CARD_FADE := 0.5 var is_dialogue_active := false var is_abort_allowed := true @@ -136,9 +155,11 @@ func _load_dialogue(dialogue_path: String) -> Dictionary: func _run_dialogue(data: Dictionary, start_node := "", stop_node := "") -> void: var nodes: Dictionary = data["nodes"] var node_id := start_node if start_node != "" else str(data["start"]) + if start_node.is_empty(): + await _play_time_card(str(data.get("time_card", ""))) while node_id != "" and node_id != stop_node and nodes.has(node_id) and not _is_abort_requested and _are_speakers_alive(): var node: Dictionary = nodes[node_id] - var options: Array = node.get("options", []) + var options := _available_options(node.get("options", [])) if options.is_empty(): node_id = await _play_line(node) else: @@ -169,18 +190,111 @@ func _are_speakers_alive() -> bool: return true +## Zeigt die Titelkarte eines Dialogs (`time_card` im Kopf der Datei, +## CR 43): Vollbild, schwarz, der Zeitsprung als Text — sie ersetzt den +## abgeschafften Erzähler bei Zeitsprüngen (CR 37). Läuft vor dem ersten +## Knoten, blendet auf, hält TIME_CARD_SECONDS und blendet ab; +## confirm/interact/cancel überspringt sie sofort. Ohne `time_card` +## passiert nichts. +func _play_time_card(text: String) -> void: + if text.is_empty(): + return + var layer := CanvasLayer.new() + layer.layer = 6 + var overlay := ColorRect.new() + overlay.set_anchors_preset(Control.PRESET_FULL_RECT) + overlay.color = Color(0.02, 0.02, 0.03, 1.0) + overlay.mouse_filter = Control.MOUSE_FILTER_IGNORE + var label := Label.new() + label.set_anchors_preset(Control.PRESET_FULL_RECT) + label.text = text + label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER + label.vertical_alignment = VERTICAL_ALIGNMENT_CENTER + label.autowrap_mode = TextServer.AUTOWRAP_WORD_SMART + label.add_theme_font_size_override("font_size", 44) + label.add_theme_color_override("font_color", Color(0.94, 0.92, 0.86)) + overlay.add_child(label) + layer.add_child(overlay) + add_child(layer) + overlay.modulate.a = 0.0 + _is_skip_requested = false + await _fade_time_card(overlay, 1.0, TIME_CARD_FADE) + var held := 0.0 + while held < TIME_CARD_SECONDS and not _is_skip_requested and not _is_abort_requested: + await get_tree().process_frame + held += get_process_delta_time() + await _fade_time_card(overlay, 0.0, TIME_CARD_FADE) + _is_skip_requested = false + layer.queue_free() + + +## Blendet die Titelkarte weich auf oder ab; ein Skip-Wunsch kürzt das +## Blenden ab, damit die Karte sofort weiterspringt. +func _fade_time_card(overlay: ColorRect, target_alpha: float, seconds: float) -> void: + var elapsed := 0.0 + var start_alpha: float = overlay.modulate.a + while elapsed < seconds and not _is_skip_requested and not _is_abort_requested: + await get_tree().process_frame + elapsed += get_process_delta_time() + overlay.modulate.a = lerpf(start_alpha, target_alpha, minf(elapsed / seconds, 1.0)) + overlay.modulate.a = target_alpha + + +## Filtert die Optionen eines Knotens nach dem `requires_flag`-Tag +## (CR 43): Eine Option mit diesem Tag erscheint NUR, wenn das genannte +## Story-Flag gesetzt und wahr ist — sonst wird sie ausgeblendet, nicht +## ausgegraut. Ohne das Tag ist eine Option immer sichtbar. +## +## Bleibt dabei keine Option übrig, behandelt _run_dialogue den Knoten +## wie eine reine Zeile und folgt seinem "next" — so bleibt ein Baum +## spielbar, dessen Varianten alle an Flags hängen (z. B. +## akt2_k4_erwachen/t_variante), statt in einer leeren Auswahl zu hängen. +func _available_options(options: Array) -> Array: + var available: Array = [] + for option in options: + if not (option is Dictionary): + continue + var flag_name := str(option.get("requires_flag", "")) + if not flag_name.is_empty() and not bool(GameState.get_story_flag(flag_name, false)): + continue + available.append(option) + return available + + ## Liefert den anzuzeigenden Text eines Knotens: Standard ist "text" ## (Fade-to-Black-Variante); trägt der Knoten ein optionales Feld ## "explicit_text" UND ist der Mature-Toggle aktiv, wird stattdessen die ## explizite Variante gezeigt (Romantik-Weiche, SPEC Abschnitt 6 — die ## expliziten Texte pflegt ausschließlich der Nutzer in den ## Dialog-Dateien, dieses Projekt liefert nur das Format). +## +## `signet_lines` (CR 43) schlägt beides: Trägt der Knoten diese Tabelle, +## wird die Zeile zu Tyrveils gewürfelter Erstkraft gewählt (Schlüssel = +## Signet-ID, Rückfall auf den Schlüssel "default"). Erst wenn beides +## fehlt, gilt der normale Knotentext. func _node_text(node: Dictionary) -> String: + var signet_line := _signet_line(node) + if not signet_line.is_empty(): + return signet_line if MatureContentGate.is_explicit_enabled and node.has("explicit_text"): return str(node["explicit_text"]) return str(node.get("text", "")) +## Wählt aus der `signet_lines`-Tabelle eines Knotens die Zeile zu +## Tyrveils gewürfelter erster Siegelkraft (CR 43). Leerer String, wenn +## der Knoten keine Tabelle trägt oder weder die Signet-ID noch ein +## "default"-Eintrag darin vorkommt. +func _signet_line(node: Dictionary) -> String: + if not (node.get("signet_lines") is Dictionary): + return "" + var lines: Dictionary = node["signet_lines"] + var signet_id := str(SignetSystem.get_first_signet().get("id", "")) + if not signet_id.is_empty() and lines.has(signet_id): + return str(lines[signet_id]) + return str(lines.get("default", "")) + + ## Zeigt eine Zeile ohne Optionen in Box und Sprechblase; die Blase (oder ## ein Fallback-Timer) bestimmt die Anzeigedauer. Liefert die ID des ## Folge-Knotens. @@ -284,6 +398,10 @@ func _apply_option_effects(option: Dictionary) -> void: if tone_shift != 0: GameState.shift_blade_heart_tone(tone_shift) _has_applied_effects = true + var bond_shift := int(option.get("bond", 0)) + if bond_shift != 0: + DragonBondSystem.adjust_bond(bond_shift) + _has_applied_effects = true var relationship_shifts: Dictionary = option.get("relationship", {}) for npc_id in relationship_shifts: RelationshipSystem.adjust_relationship(str(npc_id), int(relationship_shifts[npc_id])) diff --git a/scripts/autoloads/dragon_bond_system.gd b/scripts/autoloads/dragon_bond_system.gd index 462e4d5..296a3b4 100644 --- a/scripts/autoloads/dragon_bond_system.gd +++ b/scripts/autoloads/dragon_bond_system.gd @@ -136,6 +136,25 @@ func roll_bond(force_accept := false) -> Dictionary: } +## Liefert den laufenden Bindungswert zu Smàladh (−100..100). Er beginnt +## bei 0 und wächst über das `bond`-Tag der Dialog-Optionen (CR 43) — +## anders als die einmalige `bond_quality` des Dreschens ist das der +## Wert, der sich über Akt 2/3 entwickelt. +func get_bond() -> int: + return GameState.bond_level + + +## Verschiebt den Bindungswert relativ um amount (geklemmt). Zugriffs- +## Fassade auf den GameState, analog zu RelationshipSystem (CR 43). +func adjust_bond(amount: int) -> void: + GameState.adjust_bond_level(amount) + + +## Setzt den Bindungswert absolut (geklemmt). +func set_bond(value: int) -> void: + GameState.set_bond_level(value) + + ## Anzahl der Drachenkunde-Einheiten aus der Rotunde (Story-Flag-Zähler). func _knowledge_count() -> int: return int(GameState.get_story_flag(KNOWLEDGE_FLAG, 0)) diff --git a/scripts/autoloads/game_state.gd b/scripts/autoloads/game_state.gd index 2b52b03..78a79d1 100644 --- a/scripts/autoloads/game_state.gd +++ b/scripts/autoloads/game_state.gd @@ -10,6 +10,7 @@ extends Node ## solide Kraft und Schnelligkeit, Verstand wächst übers Spiel. signal blade_heart_tone_changed(new_tone: int) +signal bond_level_changed(new_level: int) signal relationship_changed(npc_id: String, new_value: int) signal faction_standing_changed(faction_id: String, new_value: int) signal weapon_skill_changed(weapon_id: String, new_value: int) @@ -22,6 +23,8 @@ const RELATIONSHIP_MIN := -100 const RELATIONSHIP_MAX := 100 const HUMANITY_MIN := -100 const HUMANITY_MAX := 100 +const BOND_MIN := -100 +const BOND_MAX := 100 const DEFAULT_STRENGTH := 35 const DEFAULT_AGILITY := 35 const DEFAULT_INTELLECT := 15 @@ -38,6 +41,7 @@ var agility := DEFAULT_AGILITY var intellect := DEFAULT_INTELLECT var blade_heart_tone := 0 var humanity := 0 +var bond_level := 0 var relationships: Dictionary = {} var completed_dialogues: Dictionary = {} var story_flags: Dictionary = {} @@ -58,6 +62,7 @@ func reset() -> void: intellect = DEFAULT_INTELLECT blade_heart_tone = 0 humanity = 0 + bond_level = 0 relationships.clear() completed_dialogues.clear() story_flags.clear() @@ -103,6 +108,22 @@ func shift_humanity(amount: int) -> void: humanity = clampi(humanity + amount, HUMANITY_MIN, HUMANITY_MAX) +## Verschiebt die Drachenbindung um amount (CR 43: Ziel des `bond`-Tags +## der Dialog-Optionen), klemmt auf BOND_MIN..BOND_MAX und meldet +## Änderungen über bond_level_changed. Analog zum Beziehungswert, aber +## global — Tyrveil hat genau einen Drachen. +func adjust_bond_level(amount: int) -> void: + var new_level := clampi(bond_level + amount, BOND_MIN, BOND_MAX) + if new_level != bond_level: + bond_level = new_level + bond_level_changed.emit(bond_level) + + +## Setzt die Drachenbindung absolut (geklemmt). +func set_bond_level(value: int) -> void: + adjust_bond_level(clampi(value, BOND_MIN, BOND_MAX) - bond_level) + + ## Liefert den Beziehungswert zur NPC-ID, 0 für unbekannte NPCs. func get_relationship(npc_id: String) -> int: return relationships.get(npc_id, 0) @@ -230,6 +251,7 @@ func to_save_dict() -> Dictionary: "intellect": intellect, "blade_heart_tone": blade_heart_tone, "humanity": humanity, + "bond_level": bond_level, "relationships": relationships.duplicate(), "completed_dialogues": completed_dialogues.duplicate(), "story_flags": story_flags.duplicate(), @@ -255,6 +277,7 @@ func apply_save_dict(data: Dictionary) -> void: intellect = clampi(int(data.get("intellect", DEFAULT_INTELLECT)), STAT_MIN, STAT_MAX) blade_heart_tone = clampi(int(data.get("blade_heart_tone", 0)), TONE_MIN, TONE_MAX) humanity = clampi(int(data.get("humanity", 0)), HUMANITY_MIN, HUMANITY_MAX) + bond_level = clampi(int(data.get("bond_level", 0)), BOND_MIN, BOND_MAX) relationships.clear() var saved_relationships: Dictionary = data.get("relationships", {}) for npc_id in saved_relationships: