windgeschworen/scripts/autoloads/dragon_bond_system.gd
danny 1b49711721 Phase 7: Bindung FIX = Smàladh — Dreschen-Umbau (CR 1)
- roll_bond liefert immer Smàladh (schwarzer Skorpionschwanz) aus
  data/dragons/smaladh.json; Federschwanz-Ausgang und Vater-Ziehstufe entfernt
- Daumen färben jetzt Bindungsqualität (0–100, drei Stufen) und
  Signet-Stärke statt der Drachenart; Prüfungs-Risiko bleibt (5–35 %,
  bei Permadeath AN tödlich)
- Dreschen-Reveal: Smàladh tritt aus der Reihe, Tween-Annäherung,
  Chroniken-„tot"-Moment, Kopf-an-Kopf-Stimme, stufengefärbte Dramaturgie
- Journal zeigt Smàladh, Bindungs-Stufe und Signet-Stärke
- Buchführung: CR 1 nach CHANGEREQUESTS_DONE, Phasen-Plan-Status aktualisiert

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-14 06:32:32 +02:00

160 lines
6.6 KiB
GDScript
Raw 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, 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 %. Bei Permadeath AN
## bleibt der Bindungs-Moment damit dramaturgisch tödlich möglich —
## 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). Die Qualität wählt die Stufe
## aus smaladh.json (quality_tiers, absteigend nach min_quality) und
## bestimmt darüber Signet-Stärke und die Dramaturgie des Moments —
## NICHT die Drachen-Art. Der Zirkel-Fortschritt (CR 2) kommt in
## Phase 10 als weiterer Daumen dazu.
## 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
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", "")),
}
## 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