windgeschworen/scripts/autoloads/dragon_bond_system.gd
danny f683abffd4 Docs: buchgetreue Kanon-Akten für Menschen, Drachen, Orte & Kernkonzepte
Großer Rechercheblock gegen das Empyrean-Wiki, um Claude Codes teils
erfundene Charakter-/Welt-Angaben durch belegten Buch-Kanon zu ersetzen:

- docs/humans/: alle Prio-1-NPCs (Violet, Xaden, Rhiannon, Dain, Liam,
  Sawyer, Ridoc, Jack, Professoren) + Imogen/Tyrveil dorthin verschoben,
  neu: Fen Riorson. Jede Akte trennt Buch-1-relevante Fakten explizit
  von späteren Büchern (Windgeschworen spielt in Buch 1).
- docs/dragons/: alle an dokumentierte Menschen gebundenen Drachen
  (Tairn, Andarna, Sgaeyl, Cath, Feirge, Aotrom, Sliseag, Deigh, Glane,
  Baide) + Smàladh dorthin verschoben.
- docs/locations/{citadel,main_building,outdoor}/: 20 Einzelakten zu
  Basgiath War College, inkl. Klarstellung, dass die Buch-Rotunda ein
  reiner Passagenraum ist und Windgeschworens "Drachen-Rotunde" eigentlich
  Kaoris separates Klassenzimmer abbildet.
- SIGNETS.md, DRACHEN.md, LESSER_MAGIC.md, REBELLION_RELIC.md,
  TYRRISH_REBELLION.md: neue Referenzdateien; dragons.json um
  Skorpionschwanz und das nicht bindbare Irid-Geschlecht ergänzt.
- CHARACTERS.md entschlackt: Buch-Fakten nur noch per Querverweis auf
  die jeweilige Akte statt dupliziert.
- CHANGEREQUESTS.md: offener Punkt CR 6 (Story/Dialoge gegen die neuen
  Akten abgleichen) ergänzt.
- Diverse Korrekturen an zuvor unbelegten/falschen Behauptungen (z. B.
  Imogen war nicht mit Sloane Mairi liiert).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-14 23:40:43 +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, 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). 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