windgeschworen/scripts/autoloads/dragon_bond_system.gd
danny d7f510eaf9 Phase 5: Dreschen, Bindungs-RNG, Signet-Reveal, Wahrheit 3, Journal, Epilog
- Nachtrag 4c: jack_outcome-Story-Flag (success/failed, Default
  never_encountered) in beiden Ambush-Ausgaengen
- data/dragons/dragons.json: Farben je 19, Schwarz 5; Schwaenze je 24,
  Federschwanz 4. data/signets/signets.json: zehn kanon-neutrale Signets
- DragonBondSystem: Ablehnung Basis 20% (-Herz-Ton/20 max -5,
  -(Wren+Maren)/4 max -5, -/+5 je Jack-Ausgang, geklemmt 5-35);
  Federschwanz-Gewicht 4 + Herz-Ton/10 (max +10) + (Wren+Maren)/4 (max
  +5) +1 bei Jack-Erfolg (Herz-Pfad hebt ~4% auf ~17%);
  Vater-verbundener Drache als erzaehlerische Faerbung; fixe
  Zieh-Reihenfolge fuer seedbare Tests. SignetSystem lost aus der Tabelle
- Dreschen-Szene (scenes/hatching): atmosphaerisches Set-Piece mit
  Kamera-Pan, Drachenkreis-Silhouetten, Bindungs-Sequenz ueber
  Sprechblasen; Wahrheit 3 als Moment der Bindung (Wiedererkennen statt
  Zufall, truth_3_revealed); Ablehnung bei Permadeath AN toedlich, bei
  AUS weitere Versuche (nach 3 erzwingt der Story-Modus die Bindung);
  Ergebnis in GameState.bound_dragon (gespeichert) + Auto-Save
- Journal-Grundgeruest an der journal-Action (J/Y-Dreieck), Instanz im
  Player: zeigt Drache + Signet bzw. Platzhalter, fokus-navigierbar
- Epilog (scenes/epilogue): Flug-Teaser als Platzhalter-Tableau - stiller
  Schwur, Wren winkt von unten, Rauch-Andeutung hinter der Grenze (Haken,
  nicht ausgespielt), Abspann-Bildschirm zurueck ins Hauptmenue = Ende v1
- Gauntlet-Endtrigger fuehrt jetzt ins Dreschen
- Headless verifiziert (34 Checks): Jack-Flag, beide Formel-Profile,
  kompletter Bindungs-Durchlauf mit Journal und Save-Roundtrip, Epilog
  bis Hauptmenue, geseedete Ablehnung mit Game Over bei Permadeath AN

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

121 lines
4.8 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 Abschnitte 6 und 8,
## STORY.md Abschnitt 5 Klimax).
##
## Basis-Zufall aus data/dragons/dragons.json (Farben: je 19, Schwarz 5;
## Schwänze: je 24, Federschwanz 4) plus LEICHTER Kompatibilitäts-Daumen:
## - Ablehnungs-Chance: 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"; geklemmt auf 5–35 %.
## - Federschwanz-Gewicht: Basis 4, plus Herz-Ton/10 (max +10, nur
## positiver Ton), plus (Wren+Maren)/4 (max +5), +1 bei jack "success" —
## gegen die übrigen Schwanz-Gewichte von je 24 (Herz-Pfad mit hoher
## Bindung hebt die Chance von ~4 % auf ~17 %; der Daumen auf der
## Waage aus STORY.md, kein garantierter Ausgang).
## - Vater-verbundener Drache (erzählerische Färbung, STORY.md Klimax):
## Chance = Herz-Ton/10 (max 10) + (Wren+Maren)/6 (max 5) Prozent,
## nur wenn kein Federschwanz gezogen wurde.
## Die Zieh-Reihenfolge in roll_bond ist fix (Ablehnung, Farbe, Schwanz,
## Vater-Bindung), damit Tests den Zufall seeden können. Konsequenz einer
## Ablehnung (Permadeath) liegt bei der Dreschen-Szene, nicht hier.
const DRAGONS_PATH := "res://data/dragons/dragons.json"
const REJECTION_BASE := 20
const REJECTION_MIN := 5
const REJECTION_MAX := 35
const FEATHER_BASE := 4
var _colors: Array = []
var _tails: Array = []
## Lädt die Drachen-Tabelle beim Start.
func _ready() -> void:
var file := FileAccess.open(DRAGONS_PATH, FileAccess.READ)
if file == null:
push_error("Drachen-Tabelle nicht lesbar: %s" % DRAGONS_PATH)
return
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if not (parsed is Dictionary) or not (parsed.get("colors") is Array) or not (parsed.get("tails") is Array):
push_error("Drachen-Tabelle ist ungültig: %s" % DRAGONS_PATH)
return
_colors = parsed["colors"]
_tails = parsed["tails"]
## Berechnet die aktuelle Ablehnungs-Chance 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
return clampi(chance, REJECTION_MIN, REJECTION_MAX)
## Berechnet das aktuelle Federschwanz-Gewicht (dokumentierte Formel,
## siehe Klassen-Doku).
func compute_feather_weight() -> int:
var weight := FEATHER_BASE
weight += clampi(maxi(GameState.blade_heart_tone, 0) / 10, 0, 10)
weight += clampi(_bond_sum() / 4, 0, 5)
if str(GameState.get_story_flag("jack_outcome", "never_encountered")) == "success":
weight += 1
return weight
## Berechnet die Chance in Prozent, dass der gebundene Drache mit Tyrveils
## Vater verbunden war (nur erzählerische Färbung).
func compute_father_chance() -> int:
var chance := clampi(maxi(GameState.blade_heart_tone, 0) / 10, 0, 10)
chance += clampi(_bond_sum() / 6, 0, 5)
return chance
## Würfelt eine Bindung: Ablehnung, dann Farbe, Schwanz und Vater-Bindung.
## force_accept überspringt die Ablehnung (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 color: Dictionary = _pick_weighted(_colors, "", 0)
var tail: Dictionary = _pick_weighted(_tails, "feder", compute_feather_weight())
var is_feathertail := str(tail.get("id")) == "feder"
var is_father_connected := not is_feathertail and randf() * 100.0 < compute_father_chance()
return {
"accepted": true,
"color_id": str(color.get("id")),
"color_name": str(color.get("name")),
"tail_id": str(tail.get("id")),
"tail_name": str(tail.get("name")),
"is_black": str(color.get("id")) == "schwarz",
"is_feathertail": is_feathertail,
"is_father_connected": is_father_connected,
}
## 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)
## Gewichtete Zufallswahl aus einer Tabellen-Liste; override_id ersetzt
## das Gewicht eines Eintrags (für den Federschwanz-Daumen).
func _pick_weighted(entries: Array, override_id: String, override_weight: int) -> Dictionary:
var total := 0
for entry in entries:
var weight := override_weight if str(entry.get("id")) == override_id else int(entry.get("weight", 0))
total += weight
var roll := randf() * float(total)
var cursor := 0.0
for entry in entries:
var weight := override_weight if str(entry.get("id")) == override_id else int(entry.get("weight", 0))
cursor += float(weight)
if roll < cursor:
return entry
return entries.back()