Phase 1a: GameState-Logik, Save/Load, Hauptmenue, Imogen-Testfall

- GameState: Stats, Klinge-Herz-Achse, Beziehungen, Menschlichkeit,
  Permadeath inkl. Klemmung, Signalen und Save-Serialisierung
- RelationshipSystem als Zugriffs-Fassade ueber GameState
- SaveSystem: JSON-Save/Load nach user:// mit Fehlerbehandlung
- Hauptmenue (neue Main Scene): Start/Fortsetzen/Beenden, fokus-navigierbar
  mit Tastatur und Controller, Fortsetzen nur bei vorhandenem Save
- Imogen-Platzhalter in test_ground: Area3D-Trigger, Prompt, Konsolen-Zeile,
  Beziehungs-Zuwachs (NPC-ID imogen) mit 2-s-Cooldown
- Debug-Overlay: Stats, Klinge-Herz, Beziehung Imogen, Permadeath
- Interim: menu-Action in der Testszene speichert und kehrt ins Menue zurueck
- Input-Map: slide (C/L2) und jump (Leertaste/A-Kreuz) laut neuer SPEC 9
  verdrahtet, Mechanik folgt in Phase 1b
- SPEC-Update (Roadmap, slide/jump) und Phase-1a-Prompt eingecheckt

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-04 16:25:59 +02:00
parent 06ab09dfdd
commit df795ef40d
12 changed files with 523 additions and 28 deletions

View file

@ -1,7 +1,128 @@
extends Node
## Zentraler Spielzustand (Autoload, SPEC.md Abschnitt 8).
## Zentraler Spielzustand (Autoload, SPEC.md Abschnitte 6 und 8).
##
## Hält ab Phase 1 den Zustand eines Durchlaufs: Spieler-Stats (Kraft,
## Schnelligkeit, Verstand), den Klinge-↔-Herz-Ton-Wert (-100..+100), den
## verdeckten Menschlichkeits-Messwert, den Permadeath-Toggle (Default AN)
## sowie globale Spiel-Flags. Phase 0: leeres Skelett ohne Logik.
## 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)
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 is_permadeath_enabled := true
## Setzt alle Werte auf die Startwerte eines neuen Spiels zurück.
func reset() -> void:
strength = DEFAULT_STRENGTH
agility = DEFAULT_AGILITY
intellect = DEFAULT_INTELLECT
blade_heart_tone = 0
humanity = 0
relationships.clear()
is_permadeath_enabled = true
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)
## 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(),
"is_permadeath_enabled": is_permadeath_enabled,
}
## 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)
blade_heart_tone_changed.emit(blade_heart_tone)
for npc_id in relationships:
relationship_changed.emit(npc_id, relationships[npc_id])