windgeschworen/scripts/autoloads/signet_system.gd
danny 727f546f03 Signet-Seltenheit: gewichtete Vergabe nach Kanon-Häufigkeit
roll_signet() zog bisher uniform-zufällig aus allen Signets. Jetzt
trägt jeder Eintrag in signets.json ein weight-Feld (1 = extrem selten
bis 10 = häufig), kalibriert an der Kanon-Seltenheit (z. B.
Blitzbeschwörung selten, weil im ganzen Kanon nur Violet sie hat).
signet_system.gd zieht entsprechend gewichtet statt uniform.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-14 23:40:20 +02:00

54 lines
2 KiB
GDScript

extends Node
## Signet-Vergabe nach der Bindung (Autoload, SPEC.md Abschnitte 6 und 8).
##
## Lädt die Signet-Tabelle aus data/signets/signets.json und lost nach
## erfolgreicher Bindung eine **gewichtete** einzigartige Kraft aus — der
## Reveal-Moment gehört der Dreschen-Szene, die Speicherung dem GameState
## (bound_dragon). Das "weight"-Feld pro Signet 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).
const SIGNETS_PATH := "res://data/signets/signets.json"
const DEFAULT_WEIGHT := 1
var _signets: Array = []
## Lädt die Signet-Tabelle beim Start.
func _ready() -> void:
var file := FileAccess.open(SIGNETS_PATH, FileAccess.READ)
if file == null:
push_error("Signet-Tabelle nicht lesbar: %s" % SIGNETS_PATH)
return
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if not (parsed is Dictionary) or not (parsed.get("signets") is Array):
push_error("Signet-Tabelle ist ungültig: %s" % SIGNETS_PATH)
return
_signets = parsed["signets"]
## Lost ein Signet aus, gewichtet nach dem "weight"-Feld (Dictionary mit
## id, name, description, weight) — seltenere Signets sind seltener dran.
func roll_signet() -> Dictionary:
if _signets.is_empty():
push_error("Keine Signets geladen — Fallback-Signet.")
return { "id": "windruf", "name": "Windruf", "description": "Ruft für Herzschläge einen tragenden Aufwind.", "weight": 10 }
var total_weight := 0
for signet in _signets:
total_weight += maxi(int(signet.get("weight", DEFAULT_WEIGHT)), 0)
if total_weight <= 0:
return _signets.pick_random()
var roll := randi_range(1, total_weight)
var cumulative := 0
for signet in _signets:
cumulative += maxi(int(signet.get("weight", DEFAULT_WEIGHT)), 0)
if roll <= cumulative:
return signet
return _signets.back()
## Anzahl der geladenen Signets (für Tests und Debug).
func get_signet_count() -> int:
return _signets.size()