CR 33d: Cassians Dreschen-Finale im Tal

Verdrahtet den vorab autorisierten Dialog cassian_dreschen.json zu einem
spielbaren Finale in dragon_vale: Cassian (Tag-9-Ueberlebender in beiden
Ausgaengen) stellt Tyrveil, Kampf ueber das CR-8-Encounter, danach der
erzwungene Kill.

- Kein Schema-Umbau am DialogueSystem: start_dialogue bekommt optionale
  start_node/stop_node-Parameter. cassian_dreschen.gd liest cassian_choice
  selbst (open_blade/open_heart) und faehrt den Baum in drei Segmenten:
  Konfrontation bis vor 'kampf' -> Encounter (Ausgang fix, Sieg; Niederlage
  -> letzter Spielstand) -> 'am_boden' bis vor 'toeten' -> Augen-Effekt ->
  'toeten'/'schluss'.
- Augen-Effekt als wiederverwendbare Komponente black_eyes.gd: Pupillen der
  bestehenden googly_eyes-Instanz werden per material_override pechschwarz
  und wachsen. Erstes Auftreten des Akt-3-Motivs (STORY.md §9).
- Herz-Pfad: shift_humanity(-2) beim Sieg. Danach ist Cassians Bogen zu
  (cassian_dreschen_done); bei Wiedereintritt ist er fort.
- Nebenbei gefixt: DialogueSystem dupliziert die speakers-Map jetzt, sonst
  haette _end_dialogues clear() die vom Aufrufer ueber mehrere Segmente
  geteilte Map geleert (Cassian/Player-Sprecher ab Segment 2 weg).

Verifikation: Headless-Probe 17/17 (BlackEyes apply/reset, Controller-
Arming, apply_outcome-Deltas Herz/Klinge, Dialog-Segmentierung, Wieder-
eintritt), Boot-Check aller betroffenen Szenen 0 Fehler.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-29 06:23:42 +02:00
parent 52fd2a34f4
commit 2886ed2890
10 changed files with 334 additions and 33 deletions

View file

@ -57,14 +57,21 @@ var _box: CanvasLayer
## aus den Dialog-Knoten auf Szenen-Nodes mit SpeechBubble-Kind ab; der
## Spieler läuft unter der ID "player". Läuft bereits ein Dialog, passiert
## nichts.
func start_dialogue(dialogue_path: String, speakers: Dictionary) -> void:
##
## start_node überschreibt den Einstiegsknoten (leerer String = data.start);
## stop_node beendet den Durchlauf, SOBALD dieser Knoten erreicht wird, OHNE
## ihn zu spielen (leerer String = bis zum natürlichen Ende). Beides erlaubt
## es einer Szene, denselben Dialogbaum in Segmenten zu fahren und dazwischen
## eigene Beats einzuschieben (CR 33d: Cassians `kampf`-Pause und der
## `toeten`-Augen-Effekt) — ohne Umbau am JSON-Schema.
func start_dialogue(dialogue_path: String, speakers: Dictionary, start_node := "", stop_node := "") -> void:
if is_dialogue_active:
return
var data := _load_dialogue(dialogue_path)
if data.is_empty():
return
var dialogue_id := str(data["id"])
_speakers = speakers
_speakers = speakers.duplicate()
_speaker_names = data.get("speakers", {})
_is_effect_pass = not GameState.has_completed_dialogue(dialogue_id)
_is_abort_requested = false
@ -76,7 +83,7 @@ func start_dialogue(dialogue_path: String, speakers: Dictionary) -> void:
is_abort_allowed = bool(data.get("can_abort", true))
is_dialogue_active = true
dialogue_started.emit(dialogue_id)
_run_dialogue(data)
_run_dialogue(data, start_node, stop_node)
## Merkt Abbruch- (cancel/dialogue_abort) und Skip-Wünsche
@ -126,10 +133,10 @@ func _load_dialogue(dialogue_path: String) -> Dictionary:
## dieses Autoload überlebt ihn, die Sprecher nicht), endet der Dialog
## sofort und still: keine weiteren Zeilen in der Box über der neuen
## Szene, keine Abbruch-Zeile ohne Sprecher (CR 25).
func _run_dialogue(data: Dictionary) -> void:
func _run_dialogue(data: Dictionary, start_node := "", stop_node := "") -> void:
var nodes: Dictionary = data["nodes"]
var node_id := str(data["start"])
while node_id != "" and nodes.has(node_id) and not _is_abort_requested and _are_speakers_alive():
var node_id := start_node if start_node != "" else str(data["start"])
while node_id != "" and node_id != stop_node and nodes.has(node_id) and not _is_abort_requested and _are_speakers_alive():
var node: Dictionary = nodes[node_id]
var options: Array = node.get("options", [])
if options.is_empty():

View file

@ -0,0 +1,48 @@
class_name BlackEyes
extends RefCounted
## Wiederverwendbarer Augen-Effekt (CR 33d) — Tyrveils Pupillen färben
## sich pechschwarz und wachsen, bis die Augen voll schwarz stehen.
##
## Erstes Auftreten eines Motivs, das in Akt 3 eskaliert (STORY.md §9):
## darum als Komponente gebaut, nicht als Einmal-Hack. Arbeitet auf einer
## bestehenden `googly_eyes.tscn`-Instanz (Kinder `LeftPupil`/`RightPupil`)
## über `material_override` — es werden also keine geteilten
## Sub-Ressourcen mutiert, andere Augen im selben Baum bleiben unberührt.
## `apply` ist awaitbar (endet mit dem Wachs-Tween); `reset` stellt den
## Ausgangszustand wieder her (für Wiederverwendung/Rücknahme).
const PUPIL_NAMES := ["LeftPupil", "RightPupil"]
const PITCH_BLACK := Color(0.0, 0.0, 0.0, 1.0)
const PUPIL_GROW := Vector3(2.6, 2.6, 2.6)
## Färbt die Pupillen pechschwarz und lässt sie wachsen; wartet den
## Wachs-Tween ab.
static func apply(eyes: Node3D, duration := 0.6) -> void:
if eyes == null or not is_instance_valid(eyes):
return
var last_tween: Tween = null
for pupil_name in PUPIL_NAMES:
var pupil := eyes.get_node_or_null(pupil_name) as MeshInstance3D
if pupil == null:
continue
var material := StandardMaterial3D.new()
material.albedo_color = PITCH_BLACK
pupil.material_override = material
var tween := pupil.create_tween()
tween.tween_property(pupil, "scale", PUPIL_GROW, duration).set_trans(Tween.TRANS_CUBIC).set_ease(Tween.EASE_OUT)
last_tween = tween
if last_tween != null:
await last_tween.finished
## Nimmt den Effekt zurück: Pupillen wieder normal groß, Färbung entfernt.
static func reset(eyes: Node3D) -> void:
if eyes == null or not is_instance_valid(eyes):
return
for pupil_name in PUPIL_NAMES:
var pupil := eyes.get_node_or_null(pupil_name) as MeshInstance3D
if pupil == null:
continue
pupil.material_override = null
pupil.scale = Vector3.ONE

View file

@ -0,0 +1 @@
uid://71i6xar7htmh

View file

@ -0,0 +1,142 @@
extends Node
## Cassians Dreschen-Finale im Tal (CR 33d, STORY.md §5 Klimax).
##
## Cassian hat den Tag-9-Hinterhalt in BEIDEN Ausgängen überlebt (der Code
## bestätigt nie seinen Tod). Hier stellt er Tyrveil ein letztes Mal — im
## Tal, während des Dreschens. Der Dialog (data/dialogue/cassian_dreschen.json,
## Autor) hat zwei Startknoten je nach `cassian_choice`: `open_blade` (Tyrveil
## hat ihn an Tag 9 kaum verfehlt) bzw. `open_heart` (Tyrveil hat ihn ziehen
## lassen). KEIN Schema-Umbau am DialogueSystem — dieses Skript liest
## `cassian_choice` selbst und ruft `start_dialogue()` mit dem passenden
## Start-/Stopp-Knoten auf.
##
## Ablauf über die neuen Segment-Parameter von start_dialogue:
## 1. Konfrontation vom Startknoten bis VOR `kampf` (Pause-Marker).
## 2. **Kampf** über das bestehende CR-8-Encounter-System, Ausgang fix:
## Tyrveil siegt; Niederlage führt (wie CR 16) auf den letzten Spielstand.
## 3. `am_boden`/`ende_tyrveil` bis VOR `toeten`.
## 4. **Augen-Effekt** (BlackEyes) — Tyrveils Pupillen färben sich zum
## ersten Mal pechschwarz; erstes Auftreten des Akt-3-Motivs (STORY.md §9).
## 5. `toeten`/`schluss` bis zum Ende.
## Konsequenz: Der erzwungene Kill drückt beim Herz-Pfad die Menschlichkeit
## leicht (−2). Danach ist Cassians Bogen endgültig geschlossen, unabhängig
## vom Tag-9-Ausgang.
const DIALOGUE_PATH := "res://data/dialogue/cassian_dreschen.json"
const ENEMY_SCRIPT := preload("res://scripts/gameplay/combat/enemy_combatant.gd")
const ENCOUNTER_SCRIPT := preload("res://scripts/gameplay/combat/combat_encounter.gd")
const CASSIAN_HITPOINTS := 130
const CASSIAN_DAMAGE := 15
const HEART_HUMANITY_MALUS := 2
const DONE_FLAG := "cassian_dreschen_done"
@export var cassian_path: NodePath
@export var trigger_path: NodePath
var _has_run := false
var _encounter: CombatEncounter
@onready var _cassian: Node3D = get_node(cassian_path)
## Legt den Encounter-Rahmen an und schärft den Auslöser nur, wenn der
## Tag-9-Ausgang gefallen und das Finale noch nicht gespielt ist.
func _ready() -> void:
_encounter = ENCOUNTER_SCRIPT.new()
_encounter.name = "DreschenEncounter"
add_child(_encounter)
var is_armed: bool = StorySystem.get_cassian_outcome() != "none" and not bool(GameState.get_story_flag(DONE_FLAG, false))
_cassian.visible = is_armed
if is_armed:
var trigger := get_node(trigger_path) as Area3D
trigger.body_entered.connect(_on_trigger_entered)
## Startet das Finale einmalig, sobald Tyrveil in Cassians Nähe kommt.
func _on_trigger_entered(body: Node3D) -> void:
if not body.is_in_group("player") or _has_run:
return
if DialogueSystem.is_dialogue_active:
return
_has_run = true
_run_finale(body)
## Spielt das komplette Finale als Coroutine: Konfrontation, Kampf,
## Augen-Effekt, Tötung, Konsequenzen.
func _run_finale(player: CharacterBody3D) -> void:
var choice := str(GameState.get_story_flag("cassian_choice", "heart"))
var start_node := "open_blade" if choice == "blade" else "open_heart"
var speakers := {
"cassian": _cassian,
DialogueSystem.PLAYER_SPEAKER_ID: player,
}
DialogueSystem.start_dialogue(DIALOGUE_PATH, speakers, start_node, "kampf")
await DialogueSystem.dialogue_finished
var is_won := await run_fight()
if not is_won:
print("Tod im Tal gegen Cassian — zurück zum letzten Spielstand.")
SaveSystem.reload_last_save()
return
DialogueSystem.start_dialogue(DIALOGUE_PATH, speakers, "am_boden", "toeten")
await DialogueSystem.dialogue_finished
player.set_control_locked(true)
await _play_eye_effect(player)
DialogueSystem.start_dialogue(DIALOGUE_PATH, speakers, "toeten", "")
await DialogueSystem.dialogue_finished
apply_outcome(choice)
player.set_control_locked(false)
## Spielt den Augen-Effekt auf Tyrveils bestehender GooglyEyes-Instanz;
## fehlt sie, wartet ein kurzer Ersatz-Takt.
func _play_eye_effect(player: Node3D) -> void:
var eyes := player.get_node_or_null("MeshInstance3D/GooglyEyes") as Node3D
if eyes != null:
await BlackEyes.apply(eyes)
else:
await get_tree().create_timer(0.6).timeout
## Wendet die Konsequenzen an (öffentlich, damit Sonden beide Pfade
## deterministisch prüfen können): Finale-Flag setzen, Herz-Pfad-Malus,
## Cassian als Toten hinlegen.
func apply_outcome(choice: String) -> void:
GameState.set_story_flag(DONE_FLAG, true)
if choice == "heart":
GameState.shift_humanity(-HEART_HUMANITY_MALUS)
_lay_cassian_down()
## Führt den Kampf als echten Encounter (CR 8): liefert true bei Sieg.
## Öffentlich, damit Sonden den Ausgang deterministisch setzen können.
func run_fight() -> bool:
var enemy := _ensure_combatant(_cassian, "Cassian", CASSIAN_HITPOINTS, CASSIAN_DAMAGE)
enemy.reset_combat_values()
if not _encounter.start([enemy]):
return true
var is_won: bool = await _encounter.finished
return is_won
## Hängt Cassian einen EnemyCombatant an, falls er noch keinen hat.
func _ensure_combatant(body: Node3D, display_name: String, hitpoints: int, damage: int) -> CombatActor:
var existing := body.get_node_or_null("DreschenCombat") as CombatActor
if existing != null:
return existing
var enemy: CombatActor = ENEMY_SCRIPT.new()
enemy.name = "DreschenCombat"
enemy.enemy_name = display_name
enemy.max_hitpoints = hitpoints
enemy.strike_damage = damage
body.add_child(enemy)
return enemy
## Legt Cassians Mesh in Liegeposition (der Root bleibt aufrecht, damit
## Label und Sprechblase lesbar bleiben).
func _lay_cassian_down() -> void:
var mesh := _cassian.get_node_or_null("MeshInstance3D") as Node3D
if mesh != null:
mesh.rotation.z = PI / 2.0
mesh.position.y = 0.4

View file

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

View file

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

View file

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