windgeschworen/scripts/autoloads/dragon_bond_system.gd
danny 4f299802f7 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>
2026-08-30 13:14:16 +02:00

182 lines
7.4 KiB
GDScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

extends Node
## Drachen-Bindung beim Dreschen (Autoload, SPEC.md Abschnitt 6,
## STORY.md Abschnitt 5 Klimax, docs/dragons/SMÀLADH.md; Phase 7: Bindung FIX).
##
## Tyrveils Bindung ist FIX: immer Smàladh, der totgeglaubte schwarze
## Skorpionschwanz seines Vaters (data/dragons/smaladh.json). Es gibt
## keine Zufalls-Artenwahl für den Protagonisten mehr — die Drachen-
## Tabelle (data/dragons/dragons.json) bleibt nur als Welt-Flavor für
## Lore/Lexicon geladen; Federschwänze sind Kanon-Hintergrund über
## Violets Andarna, kein Spieler-Ausgang.
##
## Die Kompatibilitäts-Daumen färben stattdessen zwei Werte:
## - **Prüfungs-Risiko** (compute_rejection_chance): Smàladh prüft den
## Sohn hart. Basis 20 %, minus Herz-Ton/20 (max −5, nur positiver
## Ton), minus (Wren+Maren-Beziehung)/4 (max −5), −5 bei jack_outcome
## "success" bzw. +5 bei "failed", Cassian-Ausgang heart −6 / blade +3,
## Drachenkunde-Wissen −1 je Einheit (max −3), Wren-Vertrauen
## (Vertrauen−50)/25 als −2..+2; geklemmt auf 5–35 %. Der
## Bindungs-Moment bleibt damit dramaturgisch tödlich möglich — der Tod
## führt auf den letzten Spielstand (CR 16); die Konsequenz liegt bei
## der Dreschen-Szene, nicht hier.
## - **Bindungsqualität** (compute_bond_quality, 0–100): Basis 40, plus
## Herz-Ton/5 (max +20, nur positiver Ton), plus (Wren+Maren)/4
## (max +15), jack "success" +5 / "failed" −5, Cassian-Ausgang
## heart +10 / blade −5, +3 je Drachenkunde-Wissen (max +9), plus
## Wren-Vertrauens-Daumen ×3 (−6..+6), plus Zirkel-Fortschritt/10
## (max +10 — Fragmente, Xadens Bestätigung, Wahrheit 2; Phase 10,
## CR 2). Die Qualität wählt die Stufe aus smaladh.json
## (quality_tiers, absteigend nach min_quality) und bestimmt darüber
## Siegelkraft-Stärke und die Dramaturgie des Moments — NICHT die
## Drachen-Art.
## roll_bond würfelt nur noch die eine Prüfung (seedbar); force_accept
## überspringt sie (Story-Modus nach mehreren Fehlversuchen).
const DRAGONS_PATH := "res://data/dragons/dragons.json"
const SMALADH_PATH := "res://data/dragons/smaladh.json"
const REJECTION_BASE := 20
const REJECTION_MIN := 5
const REJECTION_MAX := 35
const QUALITY_BASE := 40
const KNOWLEDGE_FLAG := "drachenkunde_wissen"
const CASSIAN_REJECTION_DELTAS := { "heart": -6, "blade": 3 }
const CASSIAN_QUALITY_DELTAS := { "heart": 10, "blade": -5 }
var _colors: Array = []
var _tails: Array = []
var _smaladh: Dictionary = {}
## Lädt die Lore-Drachentabelle und die Smàladh-Akte beim Start.
func _ready() -> void:
var dragons: Variant = _load_json(DRAGONS_PATH)
if dragons is Dictionary and dragons.get("colors") is Array and dragons.get("tails") is Array:
_colors = dragons["colors"]
_tails = dragons["tails"]
else:
push_error("Drachen-Tabelle ist ungültig: %s" % DRAGONS_PATH)
var smaladh: Variant = _load_json(SMALADH_PATH)
if smaladh is Dictionary and smaladh.get("quality_tiers") is Array:
_smaladh = smaladh
else:
push_error("Smàladh-Akte ist ungültig: %s" % SMALADH_PATH)
## Berechnet das aktuelle Prüfungs-Risiko in Prozent (dokumentierte
## Formel, siehe Klassen-Doku).
func compute_rejection_chance() -> int:
var chance := REJECTION_BASE
chance -= clampi(maxi(GameState.blade_heart_tone, 0) / 20, 0, 5)
chance -= clampi(_bond_sum() / 4, 0, 5)
match str(GameState.get_story_flag("jack_outcome", "never_encountered")):
"success":
chance -= 5
"failed":
chance += 5
chance += int(CASSIAN_REJECTION_DELTAS.get(StorySystem.get_cassian_outcome(), 0))
chance -= clampi(_knowledge_count(), 0, 3)
chance -= _wren_trust_lean()
return clampi(chance, REJECTION_MIN, REJECTION_MAX)
## Berechnet die Bindungsqualität 0–100 (dokumentierte Formel, siehe
## Klassen-Doku) — sie färbt Signet-Stärke und Dramaturgie des Moments.
func compute_bond_quality() -> int:
var quality := QUALITY_BASE
quality += clampi(maxi(GameState.blade_heart_tone, 0) / 5, 0, 20)
quality += clampi(_bond_sum() / 4, 0, 15)
match str(GameState.get_story_flag("jack_outcome", "never_encountered")):
"success":
quality += 5
"failed":
quality -= 5
quality += int(CASSIAN_QUALITY_DELTAS.get(StorySystem.get_cassian_outcome(), 0))
quality += clampi(_knowledge_count(), 0, 3) * 3
quality += _wren_trust_lean() * 3
quality += clampi(StorySystem.get_zirkel_progress() / 10, 0, 10)
return clampi(quality, 0, 100)
## Liefert die Qualitäts-Stufe aus der Smàladh-Akte zur angegebenen
## Bindungsqualität (erste Stufe, deren min_quality erreicht ist).
func get_quality_tier(quality: int) -> Dictionary:
var tiers: Array = _smaladh.get("quality_tiers", [])
for tier in tiers:
if quality >= int(tier.get("min_quality", 0)):
return tier
if tiers.is_empty():
return {}
return tiers.back()
## Würfelt die eine Prüfung und liefert bei Bestehen die fixe
## Smàladh-Bindung samt Qualität und Stufe. force_accept überspringt
## die Prüfung (Story-Modus lässt nach mehreren Fehlversuchen niemanden
## ungebunden zurück).
func roll_bond(force_accept := false) -> Dictionary:
if not force_accept and randf() * 100.0 < compute_rejection_chance():
return { "accepted": false }
var quality := compute_bond_quality()
var tier := get_quality_tier(quality)
return {
"accepted": true,
"dragon_id": str(_smaladh.get("id", "smaladh")),
"dragon_name": str(_smaladh.get("name", "Smàladh")),
"color_id": str(_smaladh.get("color_id", "schwarz")),
"color_name": str(_smaladh.get("color_name", "Schwarz")),
"tail_id": str(_smaladh.get("tail_id", "skorpion")),
"tail_name": str(_smaladh.get("tail_name", "Skorpionschwanz")),
"is_black": true,
"bond_quality": quality,
"quality_id": str(tier.get("id", "")),
"quality_label": str(tier.get("label", "")),
"signet_strength": str(tier.get("signet_strength", "")),
"bond_line": str(tier.get("bond_line", "")),
"reveal_line": str(tier.get("reveal_line", "")),
}
## 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))
## Wren-Vertrauens-Daumen um den Startwert 50 herum (−2..+2): hohes
## Vertrauen hilft der Bindung, verspieltes Vertrauen schadet ihr.
func _wren_trust_lean() -> int:
return clampi((StorySystem.get_wren_trust() - StorySystem.WREN_TRUST_START) / 25, -2, 2)
## Summe der Wren- und Maren-Beziehungswerte (nur positive Anteile).
func _bond_sum() -> int:
return maxi(RelationshipSystem.get_relationship("wren"), 0) + maxi(RelationshipSystem.get_relationship("maren"), 0)
## Lädt und parst eine JSON-Datei (null bei Fehler).
func _load_json(path: String) -> Variant:
var file := FileAccess.open(path, FileAccess.READ)
if file == null:
push_error("Datei nicht lesbar: %s" % path)
return null
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
return parsed