windgeschworen/scripts/gameplay/chapter_runner.gd
danny 81406818fc CR 36 + 37: Erzaehler raus, stumme Beats werden gespielt
Beides dieselbe Aufgabe an zwei Stellen, deshalb zusammen.

CR 37, Daten: Die letzten beiden Dateien mit narrator-Knoten sind umgestellt
— cassian_dreschen (kampf, toeten, schluss) und epilog_smaladh (pause, ende).
Muster wie in akt2_auftakt_staffel: Der Erzaehlertext wird Regieanweisung und
damit nie wieder angezeigt, der Knoten bleibt als WORTLOSER Beat stehen, weil
dort wirklich nichts gesagt wird. narrator ist aus beiden Sprecherlisten raus.
Damit hat keine einzige Dialogdatei mehr einen Erzaehler.

Die Knoten-IDs kampf und toeten bleiben absichtlich erhalten: cassian_dreschen.gd
benutzt sie als stop_node bzw. Wiedereinstieg. Steht jetzt auch so in ihrer
Regieanweisung, damit niemand sie fuer entbehrlich haelt.

CR 37, Bau: Die Toetung wird gespielt statt beschrieben. Nach dem Augen-Effekt
faellt Cassian sichtbar (_play_kill), dann erst laeuft der wortlose Knoten.

CR 36, Bau: Der stumme Wren-Beat. Neue wiederverwendbare Komponente
Inszenierung — die Figuren drehen sich zum Sprecher, und genau deshalb faellt
auf, dass sich zu Wren niemand dreht. Dazu das koerperliche Signal aus dem CR:
frisches Relikt an jedem am Tisch ausser ihm.

Ein Detail, das dafuer noetig war: Greybox-Kapseln sind rotationssymmetrisch,
eine Drehung waere unsichtbar gewesen. Jede Figur bekommt darum die im Projekt
etablierte Vorderseite (googly_eyes, wie an Wren, Maren und Tyrveil) — erst
damit ist "dreht sich weg" ueberhaupt lesbar.

Was wann gespielt wird, steht in data/story/inszenierung.json, nicht in den
Autoren-Dialogdateien (gleiches Muster wie akt3_k3_fall.json). Eingehaengt in
beide Stellen, die den Auftakt spielen: chapter_runner und basgiath_auftakt.

Verifikation, Sonde 13/13 mit Kontrollen:
- Keine Dialogdatei hat mehr einen narrator-Sprecher (alle geprueft).
- Kontrolle: Cassian steht vor dem Beat aufrecht und faellt dann sichtbar.
- Kontrolle: Bei Liam drehen sich die anderen zu ihm — bei Wren nicht, und
  die Gegenprobe zeigt, dass die Richtung zu Wren nachweislich eine andere
  waere. Auch im Folgeknoten sieht ihn niemand an.
- Wren traegt kein Relikt, alle anderen am Tisch schon.
Regression: Akt 2 (36 Szenen) und Akt 3 (13) laufen unveraendert durch.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 13:11:48 +02:00

256 lines
9.6 KiB
GDScript

extends Node3D
## Kapitel-Runner (CR 46) — spielt eine Szenenfolge aus einem Manifest ab.
##
## Ersetzt die Einzelverdrahtung pro Dialogdatei: Der Runner liest ein
## Kapitel-Manifest (`data/story/akt3_kapitel.json`, später auch
## `akt2_kapitel.json`) und arbeitet es ab —
## **Kapitel → Szenenliste → Dialog laden → Flags setzen → nächste Szene.**
## Die Reihenfolge im Manifest deckt sich mit den „ÜBERGANG nach …"-Notizen
## im letzten `_regie` jeder Datei; Quelle bleiben AKT2.md/AKT3.md.
##
## Für jede Szene baut der Runner die Sprecher-Figuren, die die Datei in
## ihrem `speakers`-Block nennt (Greybox: Kapsel, NameLabel, Sprechblase),
## und meldet sie dem DialogueSystem. Figuren bleiben über Szenen hinweg
## bestehen, solange sie wieder vorkommen. Akt 3 ist eine gerade Kette
## ohne offene Welt, ohne Unterricht und ohne Tageszyklus — der Runner
## braucht darum keine Spielersteuerung; Bewegung und Inszenierung kommen
## erst mit dem Szenen-Bau dazu.
##
## **Zurueckgestellte Kapitel:** Traegt ein Kapitel im Manifest
## `zurueckgestellt`, ueberspringt der Runner es und meldet es ueber
## `chapter_skipped` — samt Grund auf der Konsole. Gedacht fuer offene
## Autorenfragen, damit der Rest des Akts trotzdem laufen kann, ohne dass die
## Luecke still verschwindet.
##
## **Flags:** Die `setzt_flags` eines Kapitels werden gesetzt, wenn seine
## letzte Szene durch ist. Zusätzlich hält der Runner in
## `FLAG_CHAPTER` fest, welches Kapitel zuletzt lief, damit ein Spielstand
## mittendrin wieder einsteigen kann.
##
## **Inszenierung:** Die Figuren drehen sich zum Sprecher und tragen die
## Zeichen, die ein Beat braucht (CR 36/37) — was wann, steht in
## `data/story/inszenierung.json`. Ohne Eintrag passiert nichts.
##
## **Barks pro Szene:** Trägt ein Kapitel `barks_pro_szene`, gilt statt des
## Kapitel-Pools eine Zuordnung Szene -> Pool; Szenen ohne Eintrag bleiben
## still. Gebraucht fürs Akt-2-Zwischenspiel, das laut AKT2.md §7 ⑦ zwei
## Pools hat (`akt2_zw_basgiath` in Basgiath, `akt2_zw_hoehlen` in den Höhlen)
## und keinen gemeinsamen.
##
## **Barks:** Zu jedem Kapitel läuft sein Pool (`barks`), am Kapitelende
## wird er abgeschaltet. Kapitel ohne Pool bleiben still — Akt 3 K3
## bekommt bewusst keine Barks (AKT3.md §3). Trägt ein Kapitel
## `barks_bis`, versiegt der Pool schon nach dieser Szene (K2: „Ab da ist
## es still, und das fällt auf.").
signal chapter_started(chapter_id: String)
## Ein Kapitel wurde uebersprungen, weil es im Manifest als
## `zurueckgestellt` markiert ist (offene Autorenfrage).
signal chapter_skipped(chapter_id: String)
signal chapter_finished(chapter_id: String)
signal scene_started(scene_id: String)
signal scene_finished(scene_id: String)
signal run_finished
const DIALOGUE_DIR := "res://data/dialogue/"
const BUBBLE_SCENE := preload("res://scenes/ui/speech_bubble.tscn")
const FLAG_CHAPTER := "kapitel_aktuell"
const SCENE_GAP := 0.8
const FIGURE_RADIUS := 4.2
const PLAYER_SPEAKER := "player"
const FIGURE_COLORS := {
"player": Color(0.30, 0.50, 0.85),
"smaladh": Color(0.10, 0.09, 0.11),
"xaden": Color(0.35, 0.33, 0.40),
"imogen": Color(0.85, 0.35, 0.50),
"garrick": Color(0.55, 0.45, 0.35),
"bodhi": Color(0.45, 0.60, 0.70),
"liam": Color(0.45, 0.72, 0.55),
"rhiannon": Color(0.70, 0.60, 0.40),
"ilva": Color(0.60, 0.55, 0.65),
"buerger": Color(0.50, 0.48, 0.44),
"frau": Color(0.62, 0.52, 0.52),
}
const DEFAULT_COLOR := Color(0.55, 0.55, 0.58)
@export_file("*.json") var manifest_path := "res://data/story/akt3_kapitel.json"
@export var autostart := true
var is_running := false
var _chapters: Array = []
var _figures: Dictionary = {}
var _bark_player: Node
var _inszenierung: Inszenierung
var _ambience: Node3D
## Baut Bark-Player und Ambiente-Träger, lädt das Manifest und startet.
func _ready() -> void:
Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
_ambience = Node3D.new()
_ambience.name = "Ambience"
_ambience.position = Vector3(0, 2.2, 6.0)
var bubble := BUBBLE_SCENE.instantiate()
bubble.name = "SpeechBubble"
_ambience.add_child(bubble)
add_child(_ambience)
_bark_player = preload("res://scripts/gameplay/bark_player.gd").new()
_bark_player.name = "BarkPlayer"
add_child(_bark_player)
_bark_player.setup(bubble)
_inszenierung = Inszenierung.new()
_inszenierung.name = "Inszenierung"
add_child(_inszenierung)
_chapters = _load_manifest()
if autostart and not _chapters.is_empty():
run_all.call_deferred()
## Spielt alle Kapitel des Manifests der Reihe nach ab.
func run_all() -> void:
if is_running:
return
is_running = true
for chapter in _chapters:
if bool(chapter.get("zurueckgestellt", false)):
var skipped_id := _manifest_string(chapter, "id")
print("[runner] Kapitel zurueckgestellt, uebersprungen: %s — %s" % [
skipped_id, _manifest_string(chapter, "zurueckgestellt_grund")])
chapter_skipped.emit(skipped_id)
continue
await run_chapter(chapter)
is_running = false
SaveSystem.save_game()
run_finished.emit()
## Spielt ein einzelnes Kapitel: Bark-Pool an, Szenen der Reihe nach,
## Flags setzen, Pool aus.
func run_chapter(chapter: Dictionary) -> void:
var chapter_id := _manifest_string(chapter, "id")
GameState.set_story_flag(FLAG_CHAPTER, chapter_id)
var scene_pools: Dictionary = chapter.get("barks_pro_szene", {})
if scene_pools.is_empty():
_bark_player.start_pool(_manifest_string(chapter, "barks"))
chapter_started.emit(chapter_id)
var barks_until := _manifest_string(chapter, "barks_bis")
for scene_id in chapter.get("scenes", []):
if not scene_pools.is_empty():
_bark_player.start_pool(_manifest_string(scene_pools, str(scene_id)))
await run_scene(str(scene_id))
if barks_until == str(scene_id):
_bark_player.stop()
_bark_player.stop()
for flag in chapter.get("setzt_flags", []):
GameState.set_story_flag(str(flag), true)
chapter_finished.emit(chapter_id)
## Spielt eine einzelne Szene: Dialogdatei laden, Sprecher-Figuren
## bereitstellen, Dialog abspielen und sein Ende abwarten.
func run_scene(scene_id: String) -> void:
var path := "%s%s.json" % [DIALOGUE_DIR, scene_id]
var data := _load_json(path)
if data.is_empty():
push_error("Szene nicht spielbar (Dialogdatei fehlt oder ungültig): %s" % path)
return
scene_started.emit(scene_id)
var speakers := _ensure_figures(data.get("speakers", {}))
DialogueSystem.start_dialogue(path, speakers)
if DialogueSystem.is_dialogue_active:
await DialogueSystem.dialogue_finished
scene_finished.emit(scene_id)
await get_tree().create_timer(SCENE_GAP).timeout
## Stellt für jede Sprecher-ID der Szene eine Figur bereit (vorhandene
## werden wiederverwendet) und liefert die Sprecher-Map fürs
## DialogueSystem. Sprecher ohne Anzeigenamen (der abgeschaffte
## `narrator`) bekommen trotzdem eine Figur, damit ihre Zeilen nicht
## sprecherlos ins Leere laufen.
func _ensure_figures(speakers: Dictionary) -> Dictionary:
var map: Dictionary = {}
var ids: Array = speakers.keys()
for i in ids.size():
var speaker_id := str(ids[i])
if not _figures.has(speaker_id):
var figure := _make_figure(str(speakers[speaker_id]), speaker_id)
figure.position = _figure_position(speaker_id, i, ids.size())
add_child(figure)
_figures[speaker_id] = figure
map[speaker_id] = _figures[speaker_id]
_inszenierung.setup(map)
return map
## Platziert Tyrveil vorn in der Mitte, alle anderen im Halbkreis davor.
func _figure_position(speaker_id: String, index: int, count: int) -> Vector3:
if speaker_id == PLAYER_SPEAKER:
return Vector3(0, 0, 2.5)
var span := PI * 0.8
var angle := -span / 2.0 + span * (float(index) + 0.5) / float(maxi(count, 1))
return Vector3(sin(angle) * FIGURE_RADIUS, 0, -cos(angle) * FIGURE_RADIUS)
## Baut eine Greybox-Figur: Kapsel, NameLabel und Sprechblase.
func _make_figure(display_name: String, speaker_id: String) -> Node3D:
var root := Node3D.new()
root.name = speaker_id.capitalize()
var mesh_instance := MeshInstance3D.new()
var mesh := CapsuleMesh.new()
mesh.radius = 0.4
mesh.height = 1.8
var material := StandardMaterial3D.new()
material.albedo_color = FIGURE_COLORS.get(speaker_id, DEFAULT_COLOR)
mesh.material = material
mesh_instance.mesh = mesh
mesh_instance.position = Vector3(0, 0.9, 0)
root.add_child(mesh_instance)
if not display_name.is_empty():
var label := Label3D.new()
label.name = "NameLabel"
label.text = display_name
label.position = Vector3(0, 2.2, 0)
label.billboard = BaseMaterial3D.BILLBOARD_ENABLED
label.font_size = 48
label.outline_size = 12
root.add_child(label)
var bubble := BUBBLE_SCENE.instantiate()
bubble.name = "SpeechBubble"
bubble.position = Vector3(0, 2.7, 0)
root.add_child(bubble)
return root
## Liest ein Textfeld aus einem Manifest-Eintrag. JSON-`null` (im Manifest
## fuer Kapitel ohne Bark-Pool) gilt als leerer String — `str(null)` waere
## sonst der Text "<null>" und wuerde eine Datei dieses Namens suchen.
func _manifest_string(entry: Dictionary, key: String) -> String:
var value: Variant = entry.get(key)
return str(value) if value is String else ""
## Liest die Kapitelliste aus dem Manifest.
func _load_manifest() -> Array:
var data := _load_json(manifest_path)
if not (data.get("chapters") is Array):
push_error("Kapitel-Manifest ist ungültig: %s" % manifest_path)
return []
return data["chapters"]
## Liefert die Kapitel des geladenen Manifests (für Tests und Wiedereinstieg).
func get_chapters() -> Array:
return _chapters
## Lädt und parst eine JSON-Datei; leeres Dictionary bei Fehlern.
func _load_json(path: String) -> Dictionary:
var file := FileAccess.open(path, FileAccess.READ)
if file == null:
push_error("Datei nicht lesbar: %s" % path)
return {}
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
return parsed if parsed is Dictionary else {}