Phase 4c: Gauntlet-Klimax - Marens Tod, Wahrheit 1 & 2, Trauer-Wahl

- StorySystem mit erster Beat-Logik: Kette gauntlet_started ->
  maren_intervention -> maren_death -> truth_1_revealed ->
  truth_2_revealed -> gauntlet_completed, nur vorwaerts, als Story-Flag
  gespeichert (ueberlebt Save/Load)
- Gauntlet-Lauf (scenes/gauntlet): Kletterlauf mit Sprung-, Kletter- und
  Balken-Passagen; die Manipulation der Nordroute ist sichtbar (verkanteter
  Abschnitt, im Auftakt-Dialog benannt: ungepruefte Halterungen,
  schlechteste Startzeiten); 4 Checkpoints + KillZone - Permadeath betrifft
  ausschliesslich Tyrveils eigene Stuerze
- Marens Tod ist FIX und Permadeath-unabhaengig: Intervention (nicht
  abbrechbar), Einsturz rettet Wren, Sterbeszene liefert Wahrheit 1
  (Aussonderung, mit ihrem Hoffnungsdreh) und Wahrheit 2 (General Robert
  Rowyth, kein Deserteur, umgekehrt fuer eingeschlossene Kinder, Geschichte
  zu Kinder-als-Ausrede umgedreht) in Marens Stimme - Angst, Witz,
  Nicht-dienstags-Callback; bewusst sterbend statt per Brief, ohne
  Kinder-Namen (Wrens und Imogens Momente bleiben spaeteren Phasen)
- Trauer-Wahl direkt nach dem Tod: Klinge (kalte Wut) -15 Ton / Standing
  +2, Herz (Buendeln der Trauernden) +15 Ton / Standing +5 - staerkster
  Ton-Ausschlag des Slices; Flag gauntlet_grief, Wren-Beziehung +1/+3
- Wren erschuettert, aber sicher; bleibt in Tyrveils Naehe (STORY Akt 2),
  kein Vorgriff auf sein spaeteres Wissen
- Hub: Gauntlet-Eingang im Quadranten, Maren verschwindet nach dem
  Wendepunkt aus dem Hub, Overlay zeigt den Gauntlet-Beat
- Uebergangs-Platzhalter Richtung Dreschen (Phase 5) am Ende des Laufs
- Headless verifiziert (30 Checks): komplette Beat-Kette, beide
  Trauer-Wege, Marens Tod bei Permadeath AUS und AN, Respawn/Game-Over
  nur fuer Tyrveil, Hub-Folgen, Save/Load der Beats

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-06 17:25:17 +02:00
parent 7a4ed2d6dc
commit 77c905de62
11 changed files with 778 additions and 6 deletions

View file

@ -1,8 +1,50 @@
extends Node
## Story-Beats und Story-Flags (Autoload, SPEC.md Abschnitt 8).
##
## Steuert ab Phase 3 den Fortschritt entlang der v1-Akt-Struktur (STORY.md
## Abschnitt 5): Viadukt, die Tage, Gauntlet, Trauer und Entschluss,
## Dreschen, Teaser. Beats und Flags liegen daten-getrieben in data/story;
## erfundene Handlung über STORY.md hinaus ist ausgeschlossen. Phase 0:
## leeres Skelett ohne Logik.
## Erste echte Beat-Logik (Phase 4c): der Gauntlet-Klimax aus STORY.md
## Abschnitt 5 als geordnete Beat-Kette. Der aktuelle Beat liegt als
## Story-Flag im GameState (FLAG_GAUNTLET_BEAT) und reist damit im
## Spielstand mit. advance_gauntlet_beat() bewegt sich nur vorwärts
## entlang der Kette — der Wendepunkt ist unumkehrbar, wie der Verlust,
## den er erzählt. Beat-Bedeutung: gauntlet_started (Lauf betreten),
## maren_intervention (Maren geht dazwischen), maren_death (der Einsturz
## trifft sie — fix, unabhängig von Permadeath), truth_1_revealed /
## truth_2_revealed (ihre letzten Worte), gauntlet_completed (nach der
## Trauer-Entscheidung).
signal gauntlet_beat_changed(new_beat: String)
const FLAG_GAUNTLET_BEAT := "gauntlet_beat"
const GAUNTLET_BEATS: Array[String] = [
"none",
"gauntlet_started",
"maren_intervention",
"maren_death",
"truth_1_revealed",
"truth_2_revealed",
"gauntlet_completed",
]
## Liefert den aktuellen Gauntlet-Beat ("none", wenn noch keiner erreicht).
func get_gauntlet_beat() -> String:
return str(GameState.get_story_flag(FLAG_GAUNTLET_BEAT, "none"))
## Gibt zurück, ob die Kette den angegebenen Beat erreicht oder
## überschritten hat.
func has_reached_beat(beat: String) -> bool:
return GAUNTLET_BEATS.find(get_gauntlet_beat()) >= GAUNTLET_BEATS.find(beat)
## Rückt auf einen späteren Beat der Kette vor; Rückwärts-Sprünge und
## unbekannte Beats werden ignoriert (mit Warnung).
func advance_gauntlet_beat(new_beat: String) -> void:
var new_index := GAUNTLET_BEATS.find(new_beat)
if new_index < 0:
push_warning("Unbekannter Gauntlet-Beat: %s" % new_beat)
return
if new_index <= GAUNTLET_BEATS.find(get_gauntlet_beat()):
return
GameState.set_story_flag(FLAG_GAUNTLET_BEAT, new_beat)
gauntlet_beat_changed.emit(new_beat)

View file

@ -0,0 +1,138 @@
extends Node3D
## Ablauf-Steuerung des Gauntlet-Klimax (Phase 4c, STORY.md Abschnitte 3
## und 5 — Wendepunkt).
##
## Der Lauf der Gezeichneten ist absichtlich tödlicher angelegt
## (Auszahlung von Wahrheit 1): die Nordroute mit ungeprüften Halterungen,
## benannt im Start-Dialog, sichtbar im verkanteten Abschnitt am Ende.
## Marens Tod ist FIX und tritt unabhängig vom Permadeath-Toggle ein —
## das ist Story, kein Fail-State. Permadeath betrifft ausschließlich
## Tyrveils eigene Stürze (KillZone + Checkpoints wie am Viadukt).
## Sequenz beim Erreichen des manipulierten Abschnitts: Intervention
## (Maren geht dazwischen, nicht abbrechbar) -> Einsturz, Wren gerettet,
## Maren getroffen -> Sterbeszene mit Wahrheit 1 und 2 -> Trauer-Wahl
## Klinge/Herz (±15 Ton, Standing +2/+5) -> Beat gauntlet_completed.
## Beat-Kette und Persistenz: StorySystem. Nach dem Wendepunkt (erneutes
## Betreten) ist der Lauf frei begehbar, Maren und Wren sind fort.
const MAIN_MENU_SCENE := "res://scenes/ui/main_menu.tscn"
const START_PATH := "res://data/dialogue/gauntlet_start.json"
const INTERVENTION_PATH := "res://data/dialogue/gauntlet_intervention.json"
const DEATH_PATH := "res://data/dialogue/gauntlet_death.json"
const GRIEF_PATH := "res://data/dialogue/gauntlet_grief.json"
const MAREN_ARRIVAL_POSITION := Vector3(1, 0.1, -80)
const MAREN_FALL_POSITION := Vector3(0.8, 0.1, -81.5)
const WREN_SAFE_POSITION := Vector3(-1, 0.1, -80)
var _checkpoint_position := Vector3.ZERO
var _has_intervention_run := false
var _player: CharacterBody3D
@onready var _maren: Node3D = $Maren
@onready var _wren: Node3D = $Wren
## Verbindet Checkpoints, KillZone und Interventions-Trigger; beim ersten
## Betreten startet der Auftakt-Dialog, nach dem Wendepunkt ist der Lauf
## leer und frei begehbar.
func _ready() -> void:
_player = get_tree().get_first_node_in_group("player")
if _player != null:
_checkpoint_position = _player.global_position
for checkpoint in $Checkpoints.get_children():
checkpoint.body_entered.connect(_on_checkpoint_entered.bind(checkpoint))
$KillZone.body_entered.connect(_on_kill_zone_entered)
if StorySystem.has_reached_beat("maren_death"):
_has_intervention_run = true
_maren.queue_free()
_wren.queue_free()
$CollapsingSection.queue_free()
$InterventionTrigger.queue_free()
return
$InterventionTrigger.body_entered.connect(_on_intervention_entered)
_play_opening()
## Spielt den Auftakt-Dialog kurz nach dem Betreten.
func _play_opening() -> void:
StorySystem.advance_gauntlet_beat("gauntlet_started")
await get_tree().create_timer(0.8).timeout
if _player == null or DialogueSystem.is_dialogue_active:
return
DialogueSystem.start_dialogue(START_PATH, {
"maren": _maren,
"wren": _wren,
DialogueSystem.PLAYER_SPEAKER_ID: _player,
})
## Setzt den Respawn-Punkt auf den erreichten Abschnitts-Checkpoint.
func _on_checkpoint_entered(body: Node3D, checkpoint: Area3D) -> void:
if not body.is_in_group("player"):
return
_checkpoint_position = Vector3(checkpoint.global_position.x, 0.1, checkpoint.global_position.z)
## Sturz in den Abgrund: Game Over bei Permadeath AN, sonst Respawn —
## betrifft nur Tyrveil, nie den Story-Beat.
func _on_kill_zone_entered(body: Node3D) -> void:
if not body.is_in_group("player"):
return
if GameState.is_permadeath_enabled:
print("Game Over — der Gauntlet vergibt keine Fehler.")
Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
get_tree().change_scene_to_file.call_deferred(MAIN_MENU_SCENE)
return
body.velocity = Vector3.ZERO
body.global_position = _checkpoint_position
## Startet den Wendepunkt einmalig, sobald Tyrveil den manipulierten
## Abschnitt erreicht.
func _on_intervention_entered(body: Node3D) -> void:
if not body.is_in_group("player"):
return
if _has_intervention_run or DialogueSystem.is_dialogue_active:
return
_has_intervention_run = true
_run_climax(body)
## Spielt den kompletten Wendepunkt als Coroutine: Intervention, Einsturz,
## Sterbeszene mit den Wahrheiten, Trauer-Entscheidung.
func _run_climax(player: CharacterBody3D) -> void:
StorySystem.advance_gauntlet_beat("maren_intervention")
_maren.global_position = MAREN_ARRIVAL_POSITION
DialogueSystem.start_dialogue(INTERVENTION_PATH, {
"maren": _maren,
"wren": _wren,
DialogueSystem.PLAYER_SPEAKER_ID: player,
})
await DialogueSystem.dialogue_finished
$CollapsingSection.queue_free()
_wren.global_position = WREN_SAFE_POSITION
_maren.global_position = MAREN_FALL_POSITION
_lay_maren_down()
StorySystem.advance_gauntlet_beat("maren_death")
DialogueSystem.start_dialogue(DEATH_PATH, {
"maren": _maren,
"wren": _wren,
DialogueSystem.PLAYER_SPEAKER_ID: player,
})
await DialogueSystem.dialogue_finished
StorySystem.advance_gauntlet_beat("truth_1_revealed")
StorySystem.advance_gauntlet_beat("truth_2_revealed")
DialogueSystem.start_dialogue(GRIEF_PATH, {
"wren": _wren,
DialogueSystem.PLAYER_SPEAKER_ID: player,
})
await DialogueSystem.dialogue_finished
StorySystem.advance_gauntlet_beat("gauntlet_completed")
## Legt Marens Mesh in Liegeposition; der Root bleibt aufrecht, damit
## Sprechblase und Namens-Label lesbar über ihr stehen.
func _lay_maren_down() -> void:
var mesh := _maren.get_node("MeshInstance3D") as Node3D
mesh.rotation.z = PI / 2.0
mesh.position.y = 0.4

View file

@ -0,0 +1 @@
uid://dlqejrapkgsbe

View file

@ -10,8 +10,13 @@ extends Node3D
const MAIN_MENU_SCENE := "res://scenes/ui/main_menu.tscn"
## Setzt den Spieler auf den vom Zonen-Wechsel angeforderten Spawn-Punkt.
## Setzt den Spieler auf den vom Zonen-Wechsel angeforderten Spawn-Punkt
## und entfernt Maren aus dem Raum, sobald der Gauntlet-Wendepunkt sie
## genommen hat (StorySystem-Beat maren_death).
func _ready() -> void:
var maren := get_node_or_null("Maren")
if maren != null and StorySystem.has_reached_beat("maren_death"):
maren.queue_free()
var spawn_name := ZoneTrigger.consume_pending_spawn()
if spawn_name.is_empty():
return

View file

@ -84,6 +84,7 @@ func _process(_delta: float) -> void:
relationship_parts.append("%s %+d" % [npc_id.capitalize(), RelationshipSystem.get_relationship(npc_id)])
lines.append("Beziehungen: %s" % " ".join(relationship_parts))
lines.append("Gezeichnete-Standing: %+d (F9/F10 zum Testen)" % FactionSystem.get_standing(FactionSystem.MARKED_FACTION_ID))
lines.append("Gauntlet-Beat: %s" % StorySystem.get_gauntlet_beat())
var npc_states := PackedStringArray()
for npc in get_tree().get_nodes_in_group("npc"):
if npc.has_method("get_state_name"):