CR 43: Die vier Autoren-Tags implementieren (requires_flag, time_card, bond, signet_lines)

Vier Tags, die die Dialogdateien seit Akt 2 durchgaengig benutzen, wurden
vom DialogueSystem stillschweigend ignoriert. Jetzt wirken alle vier.

- requires_flag (13x): _available_options() blendet Optionen ohne gesetztes
  Story-Flag AUS (kein Ausgrauen). Bleibt keine Option uebrig, laeuft der
  Knoten als reine Zeile weiter und folgt seinem next — sonst hinge
  akt2_k4_erwachen/t_variante (beide Varianten flag-gebunden) in einer
  leeren Auswahl.
- bond (64x): neu GameState.bond_level (-100..100, Signal, save-persistent)
  plus Fassade DragonBondSystem.get_bond()/adjust_bond()/set_bond() analog
  zu RelationshipSystem. Die 64 Werte landen messbar im Spielstand.
- time_card (15 Dateien): Vollbild-Titelkarte vor dem ersten Knoten, weiches
  Blenden, ueberspringbar — ersetzt den Erzaehler bei Zeitspruengen (CR 37).
- signet_lines (3x): _node_text() waehlt die Zeile zu Tyrveils gewuerfelter
  Erstkraft, Rueckfall auf "default" (greift in CR 35).
- _regie/_entwurf bleiben unimplementiert; automatisierter Test prueft, dass
  kein Spiel-Skript diese Felder liest.

Datenaenderung (die einzigen zwei): Die zwei echten Options-Faelle aus der
CR-Tabelle haben das Tag bekommen — akt3_k3_smaladh "Der Brief ist weg."
(coran_brief) und akt3_k5_abschied "Frag mich naechste Woche noch mal."
(resson_rowdy). Die anderen vier CR-Stellen sind KEINE Optionen, sondern
wortlose Knoten mit bedingter _regie-Inszenierung — sie sprechen heute
nichts Falsches und gehoeren in den Szenen-Bau. Details in DONE.

Verifikation: Headless-Probe 19/19 (alle vier Tags, Klemmung, Save-
Persistenz, Skip, Leer-Auswahl), Realdaten-Probe 10/10 (beide Akt-3-Gates,
Zaehlungen 15/15/64, alle 107 Dialogdateien parsen), Boot-Check 7 Szenen
0 Fehler.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
danny 2026-08-30 13:14:16 +02:00
parent 1d250c25a5
commit 4f299802f7
7 changed files with 217 additions and 51 deletions

View file

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