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

View file

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

View file

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