windgeschworen/scripts/gameplay/chapter_runner.gd
danny b423531bb8 CR 46: Akt 2 laeuft durch den Kapitel-Runner
Derselbe Runner wie fuer Akt 3, jetzt gegen data/story/akt2_kapitel.json.
Neue Buehne scenes/akt2/akt2_runner.tscn. Der lineare Strang laeuft:
Auftakt, K1-K6 und das Zwischenspiel mit POV-Wechsel — 36 Szenen.

Zwei Erweiterungen am Runner, beide aus dem Akt-2-Bestand heraus noetig:

- barks_pro_szene: Das Zwischenspiel hat laut AKT2.md §7 (7) ZWEI Pools und
  keinen gemeinsamen — akt2_zw_basgiath im Imogen-POV in Basgiath,
  akt2_zw_hoehlen fuer die erlauschten Fragmente. Das Manifest verwies
  stattdessen auf ein akt2_zwischenspiel, das es als Datei nie gab; der Lauf
  brach dort mit "Bark-Pool nicht lesbar" ab. Ein Pool pro Kapitel reicht
  dafuer nicht, also jetzt eine Zuordnung Szene -> Pool.
- chapter_skipped: Kapitel koennen im Manifest als zurueckgestellt markiert
  werden; der Runner ueberspringt sie und meldet sie samt Grund. Gedacht fuer
  offene Autorenfragen, damit eine Luecke nicht still verschwindet.

Die offene Welt bleibt bewusst aussen vor (AKT2.md §7 (10), eigenes
CR-Paket), ebenso die vier optionalen Szenen — beides ist nachgeprueft.

K4 war von mir zurueckgestellt, solange die Reihenfolge offen war. Karsten
hat sie in 7cd2295 entschieden, das Flag ist damit hinfaellig und raus.

Verifikation, 18/18 im Gesamtlauf Akt 2 + Akt 3:
- 36 Szenen in exakter Manifest-Reihenfolge, nichts uebersprungen.
- K4 beginnt mit erwachen VOR wettkampf_karte, und zw_luecke liegt direkt
  davor — der Todes-Fakeout des Zwischenspiels ist intakt.
- zw_warten laeuft mit akt2_zw_basgiath, zw_ort mit akt2_zw_hoehlen.
- Kapitel-Flags gesetzt, darunter resson_angeflogen als Voraussetzung fuer
  Akt 3; Akt 3 schliesst an und endet mit akt3_abgeschlossen.
- Weder optionale noch Offene-Welt-Szenen laufen mit.

Nebenbefund fuer die Sonden: Akt 2 laesst sich NICHT mit "immer die erste
Antwort" abklappern. akt2_zw_suche hat eine gewollte Suchschleife — Scheune
und Fluss kehren zur Auswahl zurueck, nur der Felsriegel fuehrt weiter.

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

247 lines
9.3 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.
##
## **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 _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)
_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]
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 {}