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 "" 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 {}