windgeschworen/scripts/gameplay/bark_player.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

122 lines
3.4 KiB
GDScript

extends Node
## Bark-Pool eines Kapitels (CR 46).
##
## Spielt gewichtete Einzeiler aus `data/barks/<pool_id>.json` als
## Welt-Ambiente über eine Sprechblase — nie während eines laufenden
## Dialogs, damit die Barks der Dialog-Box nicht ins Wort fallen. Der
## Kapitel-Runner lädt zu jedem Kapitel den zugehörigen Pool und schaltet
## ihn am Kapitelende wieder ab; Kapitel ohne Pool (Akt 3 K3 — bewusst
## keine Barks) bleiben still.
##
## Gewichtung wie bei den Siegelkräften: `weight` spiegelt, wie oft eine
## Zeile fallen darf. Gespielte Zeilen werden bis zum Pool-Ende nicht
## wiederholt, damit ein Kapitel sich nicht sofort wiederholt.
const BARKS_DIR := "res://data/barks/"
const DEFAULT_WEIGHT := 1
@export var interval_min := 11.0
@export var interval_max := 19.0
var _pool: Array = []
var _unused: Array = []
var _remaining := 0.0
var _bubble: Node3D
var _pool_id := ""
## Setzt die Sprechblase, über die die Barks laufen.
func setup(bubble: Node3D) -> void:
_bubble = bubble
## Lädt den Pool eines Kapitels und schaltet ihn scharf. Leere pool_id
## (Kapitel ohne Barks) schaltet still ab. Liefert true, wenn ein Pool
## läuft.
func start_pool(pool_id: String) -> bool:
stop()
if pool_id.is_empty():
return false
var path := "%s%s.json" % [BARKS_DIR, pool_id]
var file := FileAccess.open(path, FileAccess.READ)
if file == null:
push_error("Bark-Pool nicht lesbar: %s" % path)
return false
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if not (parsed is Dictionary) or not (parsed.get("barks") is Array):
push_error("Bark-Pool ist ungültig: %s" % path)
return false
_pool = parsed["barks"]
_unused = _pool.duplicate()
_pool_id = pool_id
_reset_timer()
return not _pool.is_empty()
## Schaltet den laufenden Pool ab (Kapitelende, oder Kapitel ohne Barks).
func stop() -> void:
_pool.clear()
_unused.clear()
_pool_id = ""
## Die ID des laufenden Pools; leer, wenn gerade keiner läuft.
func get_pool_id() -> String:
return _pool_id
## Zählt das Intervall herunter und spielt die nächste Zeile — pausiert,
## solange ein Dialog läuft.
func _process(delta: float) -> void:
if _pool.is_empty() or _bubble == null or not is_instance_valid(_bubble):
return
if DialogueSystem.is_dialogue_active:
return
_remaining -= delta
if _remaining > 0.0:
return
_reset_timer()
play_bark()
## Spielt sofort eine gewichtet gezogene Zeile (öffentlich für Tests).
func play_bark() -> String:
var bark := _draw()
if bark.is_empty():
return ""
var text := str(bark.get("text", ""))
if _bubble != null and is_instance_valid(_bubble):
_bubble.show_line(text)
return text
## Zieht eine gewichtete Zeile aus den noch ungespielten; ist der Pool
## durch, füllt er sich wieder auf.
func _draw() -> Dictionary:
if _pool.is_empty():
return {}
if _unused.is_empty():
_unused = _pool.duplicate()
var total := 0
for bark in _unused:
total += maxi(int(bark.get("weight", DEFAULT_WEIGHT)), 0)
if total <= 0:
var fallback: Dictionary = _unused.pick_random()
_unused.erase(fallback)
return fallback
var roll := randi_range(1, total)
var cumulative := 0
for bark in _unused:
cumulative += maxi(int(bark.get("weight", DEFAULT_WEIGHT)), 0)
if roll <= cumulative:
_unused.erase(bark)
return bark
var last: Dictionary = _unused.back()
_unused.erase(last)
return last
## Würfelt die Pause bis zur nächsten Zeile.
func _reset_timer() -> void:
_remaining = randf_range(interval_min, interval_max)