windgeschworen/scripts/autoloads/dragon_bond_system.gd
danny 5c5f65f455 Phase 10: Der Zirkel — Wahrheits-Discovery (CR 2)
- Fünf W1-Fragment-Quellen (w1_fragment_*): Gefechtskunde-Frage,
  Aushang am Hof (ab Tag 4), Wrens Einberufungsakte in der
  Geschichtsklasse (ab Tag 6, „Weissagung"-Haken), Cassians
  Angebots-Andeutung, Graue-Bark (Pool-Einträge können min_day +
  fragment_flag tragen, gesammelte Zeilen verschwinden aus dem Umlauf)
- Xaden als aktiver Zirkel-Anker: neuer Wander-NPC am Hof mit
  Dialog-Stufen (Kennenlernen, Sammel-Auftrag, Muster-Bestätigung ab
  3 Fragmenten mit zirkel_bestaetigt + Gezeichneten-Standing +5,
  Zirkel-Wache, Trauer nach dem Wendepunkt)
- Zirkel-Fortschritt 0–100 (Fragmente ×12, Bestätigung +20, Wahrheit 2
  +20) als neuer Daumen in die Bindungsqualität (max +10);
  Muster-Board zeigt Fortschritt und Bestätigung
- Kein Gauntlet-Gate: apply_w1_gauntlet_outcome() belohnt ab 3
  Fragmenten mit Bestätigung + Fraktions-Bonus, sonst bleibt der
  Wendepunkt selbst die Enthüllung
- Buchführung: CR 2 nach CHANGEREQUESTS_DONE, Phasen-Plan auf Phase 11

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-16 18:08:42 +02:00

162 lines
6.7 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, 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 %. 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), 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", "")),
}
## 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