windgeschworen/scripts/autoloads/game_state.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

217 lines
8.5 KiB
GDScript

extends Node
## Zentraler Spielzustand (Autoload, SPEC.md Abschnitte 6 und 8).
##
## Hält den Zustand eines Durchlaufs: Stats (Kraft/Schnelligkeit/Verstand),
## Klinge-↔-Herz-Ton-Wert, Beziehungswerte pro NPC, den verdeckten
## Menschlichkeits-Messwert und den Permadeath-Toggle. Die Beziehungsdaten
## liegen laut SPEC-Roadmap (Phase 1) hier; RelationshipSystem ist die
## Zugriffs-Fassade darüber. SaveSystem serialisiert den kompletten Zustand
## über to_save_dict()/apply_save_dict(). Startwerte nach SPEC Abschnitt 4:
## solide Kraft und Schnelligkeit, Verstand wächst übers Spiel.
signal blade_heart_tone_changed(new_tone: int)
signal relationship_changed(npc_id: String, new_value: int)
signal faction_standing_changed(faction_id: String, new_value: int)
const STAT_MIN := 0
const STAT_MAX := 100
const TONE_MIN := -100
const TONE_MAX := 100
const RELATIONSHIP_MIN := -100
const RELATIONSHIP_MAX := 100
const HUMANITY_MIN := -100
const HUMANITY_MAX := 100
const DEFAULT_STRENGTH := 35
const DEFAULT_AGILITY := 35
const DEFAULT_INTELLECT := 15
var strength := DEFAULT_STRENGTH
var agility := DEFAULT_AGILITY
var intellect := DEFAULT_INTELLECT
var blade_heart_tone := 0
var humanity := 0
var relationships: Dictionary = {}
var completed_dialogues: Dictionary = {}
var story_flags: Dictionary = {}
var faction_standings: Dictionary = {}
var bound_dragon: Dictionary = {}
var is_permadeath_enabled := true
## Setzt alle Werte auf die Startwerte eines neuen Spiels zurück.
## is_permadeath_enabled bleibt bewusst unangetastet: Der Toggle ist eine
## Menü-Option und soll ein neues Spiel überleben.
func reset() -> void:
strength = DEFAULT_STRENGTH
agility = DEFAULT_AGILITY
intellect = DEFAULT_INTELLECT
blade_heart_tone = 0
humanity = 0
relationships.clear()
completed_dialogues.clear()
story_flags.clear()
faction_standings.clear()
bound_dragon.clear()
blade_heart_tone_changed.emit(blade_heart_tone)
## Erhöht einen Stat um amount (negativ = senken) und klemmt ihn auf
## STAT_MIN..STAT_MAX. Gültige Namen: "strength", "agility", "intellect".
func increase_stat(stat_name: String, amount: int) -> void:
match stat_name:
"strength":
strength = clampi(strength + amount, STAT_MIN, STAT_MAX)
"agility":
agility = clampi(agility + amount, STAT_MIN, STAT_MAX)
"intellect":
intellect = clampi(intellect + amount, STAT_MIN, STAT_MAX)
_:
push_warning("Unbekannter Stat: %s" % stat_name)
## Verschiebt den Klinge-↔-Herz-Ton-Wert um amount (negativ = Klinge,
## positiv = Herz), klemmt auf TONE_MIN..TONE_MAX und meldet Änderungen
## über blade_heart_tone_changed.
func shift_blade_heart_tone(amount: int) -> void:
var new_tone := clampi(blade_heart_tone + amount, TONE_MIN, TONE_MAX)
if new_tone != blade_heart_tone:
blade_heart_tone = new_tone
blade_heart_tone_changed.emit(blade_heart_tone)
## Verschiebt den verdeckten Menschlichkeits-Messwert mit Klemmung.
## Bewusst ohne Signal und ohne UI-Anzeige: in v1 wird der Wert laut SPEC
## nur gesammelt.
func shift_humanity(amount: int) -> void:
humanity = clampi(humanity + amount, HUMANITY_MIN, HUMANITY_MAX)
## Liefert den Beziehungswert zur NPC-ID, 0 für unbekannte NPCs.
func get_relationship(npc_id: String) -> int:
return relationships.get(npc_id, 0)
## Setzt den Beziehungswert absolut, klemmt auf RELATIONSHIP_MIN..MAX und
## meldet Änderungen über relationship_changed.
func set_relationship(npc_id: String, value: int) -> void:
var new_value := clampi(value, RELATIONSHIP_MIN, RELATIONSHIP_MAX)
if get_relationship(npc_id) != new_value:
relationships[npc_id] = new_value
relationship_changed.emit(npc_id, new_value)
## Verschiebt den Beziehungswert relativ um amount (mit Klemmung).
func adjust_relationship(npc_id: String, amount: int) -> void:
set_relationship(npc_id, get_relationship(npc_id) + amount)
## Markiert einen Dialog als bereits geführt. Liegt hier statt im
## StorySystem, weil GameState das einzige gespeicherte Autoload ist und
## das Flag Save/Load überleben muss (sonst ließen sich Dialog-Effekte
## durch Neuladen erneut abgreifen).
func mark_dialogue_completed(dialogue_id: String) -> void:
completed_dialogues[dialogue_id] = true
## Gibt zurück, ob ein Dialog bereits vollständig geführt wurde.
func has_completed_dialogue(dialogue_id: String) -> bool:
return completed_dialogues.get(dialogue_id, false)
## Setzt ein Story-Flag (z. B. wie Wren am Viadukt gerettet wurde) —
## gleiches gespeichertes Muster wie completed_dialogues, damit spätere
## Phasen darauf reagieren können.
func set_story_flag(flag_name: String, value: Variant) -> void:
story_flags[flag_name] = value
## Liest ein Story-Flag, default wenn es nicht gesetzt ist.
func get_story_flag(flag_name: String, default: Variant = null) -> Variant:
return story_flags.get(flag_name, default)
## Liefert das Fraktions-Standing (-100..100), 0 für unbekannte Fraktionen.
func get_faction_standing(faction_id: String) -> int:
return faction_standings.get(faction_id, 0)
## Setzt das Fraktions-Standing absolut (geklemmt auf -100..100) und
## meldet Änderungen über faction_standing_changed.
func set_faction_standing(faction_id: String, value: int) -> void:
var new_value := clampi(value, RELATIONSHIP_MIN, RELATIONSHIP_MAX)
if get_faction_standing(faction_id) != new_value:
faction_standings[faction_id] = new_value
faction_standing_changed.emit(faction_id, new_value)
## Verschiebt das Fraktions-Standing relativ um amount (mit Klemmung).
func adjust_faction_standing(faction_id: String, amount: int) -> void:
set_faction_standing(faction_id, get_faction_standing(faction_id) + amount)
## Speichert das Dreschen-Ergebnis (Farbe, Schwanztyp, Besonderheiten,
## Signet) — gleiches Save-Muster wie story_flags.
func set_bound_dragon(dragon: Dictionary) -> void:
bound_dragon = dragon.duplicate()
## Gibt zurück, ob Tyrveil bereits gebunden ist.
func has_bound_dragon() -> bool:
return not bound_dragon.is_empty()
## Serialisiert den kompletten Zustand als Dictionary für das SaveSystem.
func to_save_dict() -> Dictionary:
return {
"strength": strength,
"agility": agility,
"intellect": intellect,
"blade_heart_tone": blade_heart_tone,
"humanity": humanity,
"relationships": relationships.duplicate(),
"completed_dialogues": completed_dialogues.duplicate(),
"story_flags": story_flags.duplicate(),
"faction_standings": faction_standings.duplicate(),
"bound_dragon": bound_dragon.duplicate(),
"is_permadeath_enabled": is_permadeath_enabled,
"time_day": TimeSystem.day_count,
"time_slot": TimeSystem.current_slot,
"time_slot_used": TimeSystem.is_current_slot_used,
}
## Stellt den Zustand aus einem Save-Dictionary wieder her. Fehlende
## Schlüssel fallen auf Startwerte zurück, JSON-Zahlen werden auf int
## normalisiert und alle Werte geklemmt; Änderungs-Signale werden nach dem
## Laden ausgelöst.
func apply_save_dict(data: Dictionary) -> void:
strength = clampi(int(data.get("strength", DEFAULT_STRENGTH)), STAT_MIN, STAT_MAX)
agility = clampi(int(data.get("agility", DEFAULT_AGILITY)), STAT_MIN, STAT_MAX)
intellect = clampi(int(data.get("intellect", DEFAULT_INTELLECT)), STAT_MIN, STAT_MAX)
blade_heart_tone = clampi(int(data.get("blade_heart_tone", 0)), TONE_MIN, TONE_MAX)
humanity = clampi(int(data.get("humanity", 0)), HUMANITY_MIN, HUMANITY_MAX)
is_permadeath_enabled = bool(data.get("is_permadeath_enabled", true))
relationships.clear()
var saved_relationships: Dictionary = data.get("relationships", {})
for npc_id in saved_relationships:
relationships[String(npc_id)] = clampi(int(saved_relationships[npc_id]), RELATIONSHIP_MIN, RELATIONSHIP_MAX)
completed_dialogues.clear()
var saved_dialogues: Dictionary = data.get("completed_dialogues", {})
for dialogue_id in saved_dialogues:
completed_dialogues[String(dialogue_id)] = bool(saved_dialogues[dialogue_id])
story_flags.clear()
var saved_flags: Dictionary = data.get("story_flags", {})
for flag_name in saved_flags:
story_flags[String(flag_name)] = saved_flags[flag_name]
faction_standings.clear()
var saved_standings: Dictionary = data.get("faction_standings", {})
for faction_id in saved_standings:
faction_standings[String(faction_id)] = clampi(int(saved_standings[faction_id]), RELATIONSHIP_MIN, RELATIONSHIP_MAX)
bound_dragon = {}
var saved_dragon: Variant = data.get("bound_dragon", {})
if saved_dragon is Dictionary:
bound_dragon = saved_dragon.duplicate()
TimeSystem.apply_save_state(int(data.get("time_day", 1)), int(data.get("time_slot", 0)), bool(data.get("time_slot_used", false)))
blade_heart_tone_changed.emit(blade_heart_tone)
for npc_id in relationships:
relationship_changed.emit(npc_id, relationships[npc_id])