windgeschworen/scripts/gameplay/chapter_runner.gd
danny 3d665b6fc5 CR 46: Kapitel-Runner — Akt 3 laeuft komplett durch
Ersetzt die Einzelverdrahtung pro Dialogdatei durch einen daten-getriebenen
Runner: Kapitel -> Szenenliste -> Dialog laden -> Flags setzen -> naechste
Szene, gespeist aus data/story/akt3_kapitel.json.

- chapter_runner.gd: spielt Manifest-Kapitel ab, baut zu jeder Szene die im
  speakers-Block genannten Greybox-Figuren (Kapsel, NameLabel, Sprechblase)
  und meldet sie dem DialogueSystem; Figuren bleiben ueber Szenen bestehen.
  Kapitel-Flags werden nach der letzten Szene gesetzt, das laufende Kapitel
  liegt in kapitel_aktuell fuer den Wiedereinstieg.
- bark_player.gd: gewichteter Bark-Pool je Kapitel, pausiert waehrend
  laufender Dialoge, keine Sofort-Wiederholung, versiegt optional per
  barks_bis (K2: "Ab da ist es still").
- scenes/akt3/akt3_runner.tscn als Buehne fuer Akt 3.

Zwei Befunde beim Verifizieren behoben:
- Manifest-Kapitel ohne Bark-Pool tragen JSON-null; str(null) ergibt den
  Text "<null>", der Runner suchte also data/barks/<null>.json. Neuer
  Helfer _manifest_string() liest Textfelder null-sicher.
- chapter_started wurde emittiert, BEVOR der Bark-Pool lief — Zuhoerer sahen
  den Zustand des Vorkapitels. Pool startet jetzt vor dem Signal.

Verifikation: Headless-Sonde 16/16 — Akt 3 spielt von akt3_k1_anflug bis
akt3_k5_aretia durch (13 Szenen in Manifest-Reihenfolge), alle setzt_flags
und die in AKT3.md §9 (1) gelisteten Flags gesetzt, Bark-Pools laufen je
Kapitel und K3 bekommt keine. Boot-Check 4 Szenen 0 Fehler.

Akt 2 bleibt offen (gleiche Mechanik plus offene Welt/Unterricht/
Tageszyklus, AKT2 §7 (10)).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 18:04:17 +02:00

222 lines
8 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.
##
## **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:** 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)
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:
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)
_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", []):
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 {}