windgeschworen/scripts/gameplay/cassian_ambush.gd
danny b96b07b7d9 CR 8d: Encounter-Umbau — Sparring und Tag-9 auf dem echten Kampfsystem
- EnemyCombatant: Gegner-KI auf CombatActor-Basis, nähert sich, hält
  Distanz, kündigt Schläge sichtbar an und blockt gelegentlich; Werte
  über Exports, damit Partner und Schergen dieselbe Klasse nutzen
- CombatEncounter: gemeinsamer Rahmen (Kampf-Kern scharf, Gegner aktiv,
  HUD, Sieg/Niederlage über finished) — bewusst ohne Story-Logik
- Kampf-HUD (scenes/ui/combat_hud.tscn): HP + Ausdauer, ein Balken je
  Gegner, Waffe und Waffenskill
- Sparring: Timing-Duell ersetzt durch echten Encounter gegen den
  Staffel-Partner; Bewegung bleibt frei, nie tödlich (Niederlage führt
  in sparring_loss statt in den Respawn)
- Tag-9-Hinterhalt: QTE-Kette samt UI entfernt, Cassian und beide
  Schergen kämpfen gleichzeitig; Niederlage = Tod → letzter Spielstand
  (CR 16), Sieg führt unverändert in die Herz/Klinge-Weiche
- Option B gewahrt: keine Kampf-Gegner im Hub
- Buchführung: 8d nach CHANGEREQUESTS_DONE, ROADMAP nachgezogen

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-20 19:43:33 +02:00

194 lines
7 KiB
GDScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

extends Node
## Tag-9-Hinterhalt im Materialraum (v1-Ausbau Phase 4, STORY.md §5).
##
## Nach der Gefechtskunde werden Tyrveil und Wren ins Lager geschickt —
## zwischen den Regalen kesseln Cassian und zwei Schergen sie ein. Aktiv
## nur an Tag 9, solange der Cassian-Ausgang offen ist; an allen anderen
## Tagen bleiben die Akteure unsichtbar. Ablauf: nicht abbrechbarer
## Auftakt -> **echter Kampf** gegen Cassian und seine beiden Schergen
## (CR 8d, CombatEncounter: Tyrveil bewegt sich frei und nutzt die volle
## Kampf-Grammatik aus 8a–8c; das alte QTE ist ersetzt). Scheitern ist
## der Tod und führt auf den letzten Spielstand (CR 16) — die
## story-kritische Weiche geht dabei nicht verloren, der Tag wird erneut
## gespielt -> Herz/Klinge-Weiche als Dialog. Konsequenzen: HERZ = Wren bedingungslos loyal (Vertrauen
## max), temporärer Stat-Malus durch Verletzungen, Menschlichkeit
## steigt, Cassian lebt. KLINGE = Cassian final ausgeschaltet, Wren hat
## Angst (Vertrauen bricht ein), Menschlichkeit kippt. Der Ausgang liegt
## als Cassian-Outcome im GameState und fließt in Phase 6 als Daumen ins
## Dreschen (DragonBondSystem).
signal ambush_finished(outcome: String)
const INTRO_PATH := "res://data/dialogue/cassian_ambush_intro.json"
const FAIL_PATH := "res://data/dialogue/cassian_ambush_fail.json"
const CHOICE_PATH := "res://data/dialogue/cassian_ambush_choice.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 := 120
const CASSIAN_DAMAGE := 14
const SCHERGE_HITPOINTS := 70
const SCHERGE_DAMAGE := 9
const AMBUSH_DAY := 9
const HEART_STAT_MALUS := 2
@export var cassian_path: NodePath
@export var wren_path: NodePath
@export var scherge_paths: Array[NodePath] = []
@export var trigger_path: NodePath
var is_ambush_active := false
var _has_run := false
var _encounter: CombatEncounter
@onready var _cassian: Node3D = get_node(cassian_path)
@onready var _wren: Node3D = get_node(wren_path)
## Richtet die Akteure nach Tag/Ausgang aus, legt den Encounter-Rahmen
## an und verbindet den Auslöser.
func _ready() -> void:
_encounter = ENCOUNTER_SCRIPT.new()
_encounter.name = "AmbushEncounter"
add_child(_encounter)
var is_armed: bool = TimeSystem.day_count == AMBUSH_DAY and StorySystem.get_cassian_outcome() == "none"
_set_actors_visible(is_armed)
if is_armed:
var trigger := get_node(trigger_path) as Area3D
trigger.body_entered.connect(_on_trigger_entered)
## Startet den Hinterhalt, sobald Tyrveil zwischen die Regale läuft.
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
is_ambush_active = true
_run_ambush(body)
## Spielt den kompletten Hinterhalt als Coroutine: Auftakt, echter Kampf
## (Scheitern = Tod, letzter Spielstand), Herz/Klinge-Weiche, Konsequenzen.
func _run_ambush(player: CharacterBody3D) -> void:
DialogueSystem.start_dialogue(INTRO_PATH, {
"cassian": _cassian,
"wren": _wren,
DialogueSystem.PLAYER_SPEAKER_ID: player,
})
await DialogueSystem.dialogue_finished
var is_won := await run_fight()
if not is_won:
DialogueSystem.start_dialogue(FAIL_PATH, {
"cassian": _cassian,
DialogueSystem.PLAYER_SPEAKER_ID: player,
})
await DialogueSystem.dialogue_finished
print("Tod im Materialraum — zurück zum letzten Spielstand.")
SaveSystem.reload_last_save()
return
DialogueSystem.start_dialogue(CHOICE_PATH, {
"cassian": _cassian,
"wren": _wren,
DialogueSystem.PLAYER_SPEAKER_ID: player,
})
await DialogueSystem.dialogue_finished
var choice := str(GameState.get_story_flag("cassian_choice", "heart"))
apply_outcome(choice)
is_ambush_active = false
ambush_finished.emit(choice)
## Wendet die Konsequenzen der Weiche an (öffentlich, damit Tests beide
## Zweige deterministisch prüfen können).
func apply_outcome(choice: String) -> void:
GameState.set_story_flag("materialraum_hinterhalt_done", true)
while StorySystem.get_cassian_escalation() < StorySystem.CASSIAN_ESCALATION_MAX:
StorySystem.escalate_cassian()
if choice == "blade":
StorySystem.set_cassian_outcome("blade")
StorySystem.adjust_wren_trust(-40)
GameState.shift_humanity(-3)
GameState.set_story_flag("wren_angst", true)
_lay_cassian_down()
_hide_schergen()
else:
StorySystem.set_cassian_outcome("heart")
StorySystem.adjust_wren_trust(100)
GameState.shift_humanity(3)
GameState.set_story_flag("wren_loyal", true)
GameState.increase_stat("strength", -HEART_STAT_MALUS)
GameState.increase_stat("agility", -HEART_STAT_MALUS)
GameState.set_story_flag("heart_stat_malus", HEART_STAT_MALUS)
_cassian.visible = false
_hide_schergen()
## Führt den eigentlichen Kampf als echten Encounter (CR 8d): Cassian
## und seine beiden Schergen greifen gemeinsam an, Tyrveil bewegt sich
## frei und nutzt die volle Grammatik. Liefert true bei Sieg. Öffentlich,
## damit Sonden den Ausgang deterministisch setzen können.
func run_fight() -> bool:
var enemies := _build_enemies()
if enemies.is_empty() or not _encounter.start(enemies):
return true
var is_won: bool = await _encounter.finished
return is_won
## Legt für Cassian und die Schergen je einen Kampf-Knoten an (einmalig)
## und liefert die Liste der lebenden Gegner.
func _build_enemies() -> Array:
var enemies: Array = []
enemies.append(_ensure_combatant(_cassian, "Cassian", CASSIAN_HITPOINTS, CASSIAN_DAMAGE))
for path in scherge_paths:
var scherge := get_node_or_null(path) as Node3D
if scherge != null:
enemies.append(_ensure_combatant(scherge, "Scherge", SCHERGE_HITPOINTS, SCHERGE_DAMAGE))
for enemy in enemies:
enemy.reset_combat_values()
return enemies
## Hängt einem Akteur 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("AmbushCombat") as CombatActor
if existing != null:
return existing
var enemy: CombatActor = ENEMY_SCRIPT.new()
enemy.name = "AmbushCombat"
enemy.enemy_name = display_name
enemy.max_hitpoints = hitpoints
enemy.strike_damage = damage
body.add_child(enemy)
return enemy
## Legt Cassians Mesh in Liegeposition (Klinge-Ausgang); 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
## Blendet die Schergen aus (sie fliehen).
func _hide_schergen() -> void:
for path in scherge_paths:
var scherge := get_node_or_null(path) as Node3D
if scherge != null:
scherge.visible = false
## Blendet alle Hinterhalt-Akteure ein oder aus.
func _set_actors_visible(is_visible_now: bool) -> void:
_cassian.visible = is_visible_now
_wren.visible = is_visible_now
for path in scherge_paths:
var scherge := get_node_or_null(path) as Node3D
if scherge != null:
scherge.visible = is_visible_now