windgeschworen/scripts/autoloads/signet_system.gd
danny 1d250c25a5 CR 35: Siegelkraft-Reveal vom Dreschen nach Akt 2 (K2) verschieben
Tyrveils erste, offensive Siegelkraft manifestiert sich nicht mehr beim
Dreschen (Kanon: Kraefte brauchen Wochen bis Monate nach der Bindung,
SIGNETS.md/LESSER_MAGIC.md). Blocker fuer den Akt-2-Bau.

- Wuerfeln bleibt beim Dreschen, aber still: neu grant_first_signet()
  nach dem Muster von grant_second_signet() — Ergebnis in Story-Flags
  (erstsignet_id/_strength/_revealed), NICHT im bound_dragon-Record.
  Damit ist das Ergebnis frueh festgezurrt und save-persistent.
- dragon_vale.gd: beide Reveal-Zeilen raus, keine signet_*-Felder mehr
  im dragon_record. Der Moment gehoert Wahrheit 3 und Smaladh.
- lexicon.gd: SIEGELKRAFT-Block erst nach is_first_signet_revealed() —
  vorher kein Eintrag und kein verraterischer Platzhalter.
- Neuer K2-Hook reveal_first_signet(): enthuellt die still gewuerfelte
  Kraft, schreibt sie in den dragon_record, schaltet das Lexicon frei,
  idempotent. Szenen-Kontext kommt mit dem Akt-2-Bau.
- Toter Code entfernt: hatching_grounds.gd + .tscn geloescht. Seit
  CR 33b/33c zeigt keine Tuer mehr dorthin, die Datei trug dieselbe
  Reveal-Logik ein zweites Mal.

Verifikation: Headless-Probe 19/19 (still+offensiv gewuerfelt, kein
Signet im Record, Lexicon vorher/nachher, Save-Persistenz ueber
save/reset/load, Hook idempotent, keine Reveal-Zeile mehr, toter Code
weg), Boot-Check 6 Szenen 0 Fehler.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-08-30 13:05:56 +02:00

203 lines
8.5 KiB
GDScript

extends Node
## Siegelkraft-Vergabe nach der Bindung (Autoload, SPEC.md Abschnitte 6
## und 8; CR 6, revidiert durch CR 32).
##
## Lädt die Siegelkraft-Tabelle aus data/signets/signets.json und lost
## nach erfolgreicher Bindung eine **gewichtete** Kraft aus — der
## Reveal-Moment gehört der Dreschen-Szene, die Speicherung dem
## GameState (bound_dragon). Das "weight"-Feld spiegelt die
## Kanon-Seltenheit (SIGNETS.md): kanonisch einzigartige/klassifizierte
## Kräfte wie Blitz- oder Schattenbeschwörung sind selten (weight 1-2),
## verbreitete wie Feuer- oder Eisbeschwörung häufig (weight 8-10).
##
## **Tyrveils Sonderregel (CR 32):** Nur der Protagonist zieht zweimal,
## aus getrennten Pools — die erste Kraft aus dem **Offensiv**-Pool, die
## zweite aus dem **Defensiv**-Pool (still, geheim). Alle anderen Reiter
## behalten ihre Kanon-/Zufalls-Kräfte aus der ganzen Tabelle;
## roll_signet() ohne Kategorie tut genau das.
##
## **Erstkraft erst in Akt 2 K2 (CR 35):** Siegelkräfte brauchen laut Kanon
## Wochen bis Monate nach der Bindung (SIGNETS.md, LESSER_MAGIC.md). Beim
## Dreschen wird die erste Kraft daher nur noch **still gewürfelt**
## (grant_first_signet — dasselbe Muster wie grant_second_signet: Ergebnis
## in Story-Flags, NICHT in den bound_dragon-Record, also auch nicht im
## Lexicon). Das Zufallsergebnis steht damit früh fest und ist
## save-persistent. Enthüllt wird es erst in Akt 2, Kapitel 2, über
## reveal_first_signet(): das schreibt die Kraft in den dragon_record und
## schaltet damit die Lexicon-Anzeige frei.
##
## Die zweite Kraft kommt, weil Smàladh Tyrveil aus der direkten
## Blutlinie seines früheren Reiters bindet. Sie ist erzählerisch
## **dieselbe geheime Gabe seines Vaters Robert** — welche defensive Form
## der Würfel auch wählt (Rahmung: data/signets/zweitsignet.json).
## grant_second_signet() legt sie nur als Story-Flags ab, NIE im
## normalen Reveal und nie im Lexicon; in v1 bleibt sie latent, die
## Ausspielung ist Akt-3-Stoff. Der Xaden-erkennt-es-Beat läuft über
## xaden_zirkel.gd.
const SIGNETS_PATH := "res://data/signets/signets.json"
const SECOND_SIGNET_PATH := "res://data/signets/zweitsignet.json"
const DEFAULT_WEIGHT := 1
const CATEGORY_OFFENSIVE := "offensiv"
const CATEGORY_DEFENSIVE := "defensiv"
const CATEGORY_NEUTRAL := "neutral"
const FLAG_ZWEITSIGNET := "zweitsignet_latent"
const FLAG_ZWEITSIGNET_ID := "zweitsignet_id"
const FLAG_ZWEITSIGNET_NAME := "zweitsignet_name"
const FLAG_ERSTSIGNET_ID := "erstsignet_id"
const FLAG_ERSTSIGNET_STRENGTH := "erstsignet_strength"
const FLAG_ERSTSIGNET_REVEALED := "erstsignet_revealed"
var _signets: Array = []
var _second_signet: Dictionary = {}
## Lädt die Siegelkraft-Tabelle und die Zweitsignet-Rahmung beim Start.
func _ready() -> void:
var file := FileAccess.open(SIGNETS_PATH, FileAccess.READ)
if file == null:
push_error("Siegelkraft-Tabelle nicht lesbar: %s" % SIGNETS_PATH)
else:
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if parsed is Dictionary and parsed.get("signets") is Array:
_signets = parsed["signets"]
else:
push_error("Siegelkraft-Tabelle ist ungültig: %s" % SIGNETS_PATH)
var second_file := FileAccess.open(SECOND_SIGNET_PATH, FileAccess.READ)
if second_file == null:
push_error("Zweitsignet-Rahmung nicht lesbar: %s" % SECOND_SIGNET_PATH)
return
var second_parsed: Variant = JSON.parse_string(second_file.get_as_text())
second_file.close()
if second_parsed is Dictionary and second_parsed.has("origin"):
_second_signet = second_parsed
else:
push_error("Zweitsignet-Rahmung ist ungültig: %s" % SECOND_SIGNET_PATH)
## Lost eine Siegelkraft aus, gewichtet nach dem "weight"-Feld. Ohne
## Kategorie zieht sie aus der ganzen Tabelle (alle Reiter außer
## Tyrveil); mit Kategorie nur aus dem passenden Pool (CR 32).
func roll_signet(category := "") -> Dictionary:
var pool := get_pool(category)
if pool.is_empty():
push_error("Keine Siegelkräfte für Kategorie '%s' — Fallback." % category)
return { "id": "windruf", "name": "Windruf", "description": "Ruft für Herzschläge einen tragenden Aufwind.", "weight": 10, "category": CATEGORY_NEUTRAL }
var total_weight := 0
for signet in pool:
total_weight += maxi(int(signet.get("weight", DEFAULT_WEIGHT)), 0)
if total_weight <= 0:
return pool.pick_random()
var roll := randi_range(1, total_weight)
var cumulative := 0
for signet in pool:
cumulative += maxi(int(signet.get("weight", DEFAULT_WEIGHT)), 0)
if roll <= cumulative:
return signet
return pool.back()
## Alle Siegelkräfte einer Kategorie; leere Kategorie = ganze Tabelle.
func get_pool(category := "") -> Array:
if category.is_empty():
return _signets
var pool: Array = []
for signet in _signets:
if str(signet.get("category", "")) == category:
pool.append(signet)
return pool
## Würfelt Tyrveils erste, offensive Siegelkraft beim Dreschen **still**
## (CR 35): Das Ergebnis steht damit früh fest und ist save-persistent,
## landet aber nur in Story-Flags — nicht im bound_dragon-Record und
## damit nicht im Lexicon. Kein Reveal, keine Zeile. `strength` kommt aus
## der Bindungsqualität und wird für den späteren Reveal mitgesichert.
## Liefert die gezogene Kraft zurück (für Tests und den K2-Reveal).
func grant_first_signet(strength := "") -> Dictionary:
var signet := roll_signet(CATEGORY_OFFENSIVE)
GameState.set_story_flag(FLAG_ERSTSIGNET_ID, str(signet.get("id", "")))
GameState.set_story_flag(FLAG_ERSTSIGNET_STRENGTH, strength)
GameState.set_story_flag(FLAG_ERSTSIGNET_REVEALED, false)
return signet
## Enthüllt die still gewürfelte Erstkraft (Akt 2, Kapitel 2 — CR 35):
## schreibt sie in den bound_dragon-Record und schaltet damit die
## Lexicon-Seite frei. Der Szenen-Kontext (Dialog, Kameraführung) kommt
## mit dem Akt-2-Bau; dieser Hook liefert nur den Zustandswechsel und die
## enthüllte Kraft zurück. Ohne gewürfelte Erstkraft oder ohne Bindung
## passiert nichts (leeres Dictionary).
func reveal_first_signet() -> Dictionary:
if is_first_signet_revealed():
return get_first_signet()
var signet := get_first_signet()
if signet.is_empty() or not GameState.has_bound_dragon():
return {}
var record: Dictionary = GameState.bound_dragon.duplicate()
record["signet_id"] = str(signet.get("id", ""))
record["signet_name"] = str(signet.get("name", ""))
record["signet_description"] = str(signet.get("description", ""))
GameState.set_bound_dragon(record)
GameState.set_story_flag(FLAG_ERSTSIGNET_REVEALED, true)
return signet
## Gibt zurück, ob die Erstkraft bereits enthüllt wurde (K2).
func is_first_signet_revealed() -> bool:
return bool(GameState.get_story_flag(FLAG_ERSTSIGNET_REVEALED, false))
## Liefert die still gewürfelte Erstkraft aus den Story-Flags — leeres
## Dictionary, solange beim Dreschen nicht gewürfelt wurde.
func get_first_signet() -> Dictionary:
var signet_id := str(GameState.get_story_flag(FLAG_ERSTSIGNET_ID, ""))
if signet_id.is_empty():
return {}
return get_signet_by_id(signet_id)
## Vergibt Tyrveils geheime zweite Siegelkraft still (CR 32): würfelt sie
## aus dem Defensiv-Pool und legt sie nur als Story-Flags ab — kein
## Reveal, keine Anzeige, keine Ausspielung in v1. Liefert die gezogene
## Kraft zurück (für Tests und spätere Akt-3-Beats).
func grant_second_signet() -> Dictionary:
var signet := roll_signet(CATEGORY_DEFENSIVE)
GameState.set_story_flag(FLAG_ZWEITSIGNET, true)
GameState.set_story_flag(FLAG_ZWEITSIGNET_ID, str(signet.get("id", "")))
GameState.set_story_flag(FLAG_ZWEITSIGNET_NAME, str(signet.get("name", "")))
return signet
## Gibt zurück, ob das latente Zweitsignet bereits vergeben wurde.
func has_second_signet() -> bool:
return bool(GameState.get_story_flag(FLAG_ZWEITSIGNET, false))
## Liefert die gewürfelte zweite Siegelkraft aus den Story-Flags —
## leeres Dictionary, solange sie nicht vergeben wurde.
func get_second_signet() -> Dictionary:
if not has_second_signet():
return {}
return get_signet_by_id(str(GameState.get_story_flag(FLAG_ZWEITSIGNET_ID, "")))
## Die erzählerische Rahmung der zweiten Kraft (Herkunft beim Vater,
## Geheimhaltung, ab welchem Akt sie spielbar wird) — gilt für jede
## gewürfelte Form.
func get_second_signet_lore() -> Dictionary:
return _second_signet
## Sucht eine Siegelkraft über ihre ID; leeres Dictionary, wenn unbekannt.
func get_signet_by_id(signet_id: String) -> Dictionary:
for signet in _signets:
if str(signet.get("id", "")) == signet_id:
return signet
return {}
## Anzahl der geladenen Siegelkräfte (für Tests und Debug).
func get_signet_count() -> int:
return _signets.size()