windgeschworen/scripts/gameplay/zone_trigger.gd
danny 27257d4af1 CR 30: Tueren sagen in Charakter ab statt per Fahrplan-Meldung
Statt der einen generischen Meldung "Laut Fahrplan gerade geschlossen." fuer
alle gesperrten Tueren traegt jetzt jeder Raum seinen eigenen Text. Sie
stehen als refusal je Raum in data/story/raeume.json — derselben Datei, in
der seit CR 28/29 schon Anzeigename, Stundenplan-Bezeichnung und Ziel-Zeile
eines Raumes stehen. Geladen wird einmalig statisch fuer alle Trigger, damit
vierzehn Tueren nicht vierzehnmal dieselbe Datei oeffnen; Raeume ohne eigenen
Text fallen auf refusal_fallback zurueck.

Die sieben Texte begruenden sich aus dem Raum, nicht aus der Mechanik — keiner
erwaehnt Fahrplan oder Slots. Kaori hat niemanden bestellt und die Rotunde ist
voller Drachen; Imogens Tuer ist schlicht abgeschlossen; wer ohne Auftrag ans
Material geht, steht am naechsten Tag auf einer anderen Liste.

_is_open() ist unveraendert geblieben, wie in der CR verlangt.

Verifiziert mit dev_cr30_probe (15/15: jede Hub-Tuer hat einen eigenen, von
allen anderen verschiedenen Text, keine faellt auf den Standard zurueck,
unbekannte room_id nutzt den Fallback, die Absage erscheint am Tuerschild und
wird danach zurueckgesetzt) und einem Boot-Check ueber zehn Szenen; Sonde vor
dem Commit geloescht.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-22 18:37:56 +02:00

134 lines
4.9 KiB
GDScript

class_name ZoneTrigger
extends Area3D
## Zonen-Wechsel-Trigger zwischen den Greybox-Hub-Räumen (Phase 1b;
## Fahrplan-Sperre v1-Ausbau Phase 6).
##
## Lädt beim Betreten durch den Spieler die Zielszene und merkt sich
## statisch den Namen des Spawn-Punkts, an dem der Ziel-Raum den Spieler
## platziert (hub_room.gd liest ihn über consume_pending_spawn()). Der
## Szenenwechsel läuft deferred, weil body_entered während des
## Physik-Schritts feuert. Trägt der Trigger eine room_id, wird der
## Wechsel nur zugelassen, wenn der Raum laut Fahrplan
## (StorySystem.is_room_available) im aktuellen Slot offen ist —
## andernfalls zeigt das Tür-Label kurz eine Absage. Leere room_id =
## immer offen (Rückwege zum Hof, Schlafsaal, Gauntlet).
##
## Die Absage ist **pro Raum** formuliert (CR 30): Kaoris Rotunde ist
## voller Drachen, Imogens Tür ist schlicht abgeschlossen, die
## Materialkammer verriegelt. Die Texte stehen in
## data/story/raeume.json; Räume ohne eigenen Text fallen auf
## REFUSAL_FALLBACK zurück. An der Verfügbarkeits-Prüfung selbst
## (_is_open) ändert das nichts.
const ROOMS_PATH := "res://data/story/raeume.json"
const REFUSAL_FALLBACK := "Zu. Nicht jetzt."
const REFUSAL_SECONDS := 2.2
const REFUSAL_COLOR := Color(1.0, 0.55, 0.4, 1.0)
static var _pending_spawn_name := ""
static var _refusal_texts: Dictionary = {}
static var _refusal_fallback := REFUSAL_FALLBACK
static var _are_texts_loaded := false
@export_file("*.tscn") var target_scene_path: String
@export var target_spawn_name: String
@export var room_id := ""
var _refusal_timer: Timer
## Liefert den gemerkten Spawn-Punkt-Namen des letzten Zonen-Wechsels und
## leert ihn dabei; leerer String, wenn kein Wechsel ansteht.
static func consume_pending_spawn() -> String:
var spawn_name := _pending_spawn_name
_pending_spawn_name = ""
return spawn_name
## Verbindet das Betreten-Signal des Triggers und stellt sicher, dass die
## Absagetexte geladen sind.
func _ready() -> void:
_load_refusal_texts()
body_entered.connect(_on_body_entered)
## Lädt die raumspezifischen Absagetexte einmalig für alle Trigger.
static func _load_refusal_texts() -> void:
if _are_texts_loaded:
return
_are_texts_loaded = true
var file := FileAccess.open(ROOMS_PATH, FileAccess.READ)
if file == null:
push_error("Raum-Daten nicht lesbar: %s" % ROOMS_PATH)
return
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if not (parsed is Dictionary) or not (parsed.get("rooms") is Dictionary):
push_error("Raum-Daten sind ungültig: %s" % ROOMS_PATH)
return
_refusal_fallback = str(parsed.get("refusal_fallback", REFUSAL_FALLBACK))
var rooms: Dictionary = parsed["rooms"]
for room_id in rooms:
var text := str(rooms[room_id].get("refusal", ""))
if not text.is_empty():
_refusal_texts[str(room_id)] = text
## Der Absagetext dieser Tür — raumspezifisch, sonst der Standardtext.
func get_refusal_text() -> String:
_load_refusal_texts()
return str(_refusal_texts.get(room_id, _refusal_fallback))
## Startet den Zonen-Wechsel, sobald der Spieler den Trigger betritt;
## laut Fahrplan geschlossene Räume weisen stattdessen ab.
func _on_body_entered(body: Node3D) -> void:
if not body.is_in_group("player"):
return
if not _is_open():
_show_refusal()
return
_pending_spawn_name = target_spawn_name
print("[tuerwechsel] %s -> %s (Tag %d, Slot %d)" % [
get_tree().current_scene.scene_file_path.get_file(),
target_scene_path.get_file(), TimeSystem.day_count, TimeSystem.current_slot])
get_tree().change_scene_to_file.call_deferred(target_scene_path)
## Prüft die Fahrplan-Verfügbarkeit des Ziel-Raums im aktuellen Slot;
## Trigger ohne room_id sind immer offen.
func _is_open() -> bool:
if room_id.is_empty():
return true
return StorySystem.is_room_available(room_id, TimeSystem.day_count, TimeSystem.get_slot_id())
## Färbt das Tür-Label kurz als Absage um und stellt es danach wieder
## her; erneute Absagen starten die Anzeigedauer neu. Der Rücksteller
## läuft über einen Kind-Timer statt über await (CR 25): Ein
## SceneTreeTimer überlebt den Szenenwechsel und ließe die Coroutine
## als Zombie zurück — der Kind-Timer stirbt mit der Tür.
func _show_refusal() -> void:
var label := get_node_or_null("Label3D") as Label3D
if label == null:
return
if _refusal_timer == null:
_refusal_timer = Timer.new()
_refusal_timer.one_shot = true
_refusal_timer.timeout.connect(_restore_label)
add_child(_refusal_timer)
if _refusal_timer.is_stopped():
label.set_meta("default_text", label.text)
label.set_meta("default_modulate", label.modulate)
label.text = get_refusal_text()
label.modulate = REFUSAL_COLOR
_refusal_timer.start(REFUSAL_SECONDS)
## Stellt das Tür-Label nach der Absage wieder her.
func _restore_label() -> void:
var label := get_node_or_null("Label3D") as Label3D
if label == null:
return
label.text = str(label.get_meta("default_text", label.text))
label.modulate = label.get_meta("default_modulate", label.modulate)