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>
This commit is contained in:
parent
4f299802f7
commit
3d665b6fc5
6 changed files with 402 additions and 1 deletions
122
scripts/gameplay/bark_player.gd
Normal file
122
scripts/gameplay/bark_player.gd
Normal file
|
|
@ -0,0 +1,122 @@
|
|||
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)
|
||||
Loading…
Add table
Add a link
Reference in a new issue