windgeschworen/scripts/gameplay/zone_trigger.gd
danny 37f7ca4e5b CR 25: Tuerwechsel-Crash — Haertung + Forensik, Ursache noch offen
Untersuchung: In vier eskalierenden Reproduktions-Aufbauten (headless direkt,
Doppel-Trigger im selben Frame, windowed, windowed mit echtem
Physik-body_entered und stehender Absage) ueber 175+ Tuerwechsel kein Absturz
und kein einziger Fehlertext. Die Verdachtsstelle aus der CR
(zone_trigger-await) ist in Godot 4.7 nachweislich still: Coroutinen auf
freigegebenen Instanzen brechen stumm ab, gebundene Timer-Signale werden beim
Freigeben getrennt, freigegebene Objekte vergleichen sich gleich null. Die
gesamte freed-instance-Klasse scheidet als Ursache aus. Symptombild laut
Rueckfrage (Fenster minimiert sich, Standbild, wechselnde Tueren) passt zu
einem Stall oder Fokus-Verlust jenseits der Skript-Ebene — das laesst sich
erst mit einem echten Log belegen.

Trotzdem gehaertet, weil beim Suchen zwei echte (stille) Fehler auffielen:
zone_trigger stellt das Absage-Label jetzt ueber einen Kind-Timer statt await
zurueck — kein Zombie-Rest nach dem Wechsel. Und stirbt die Szene unter einem
laufenden Dialog weg (Auto-Start-Szenen wie Appell koennen mit einem
Tuertrigger um denselben Frame rasen), endete der Dialog vorher NIE: die
Autoload-Coroutine hing fuer immer im choose()-Await und legte die Box ueber
die neue Szene. DialogueSystem prueft jetzt pro Frame, ob die Sprecher noch
leben, und beendet den Dialog still; die Box kann eine offene Auswahl von
aussen aufloesen.

Forensik fuer den naechsten Vorfall: Log-Aufbewahrung auf 30 Dateien erhoeht
und jeder Tuerwechsel schreibt eine [tuerwechsel]-Zeile ins Log. Beim
naechsten Standbild die neueste Datei aus
%APPDATA%/Godot/app_userdata/Windgeschworen/logs/ sichern.

CR 25 bleibt in CHANGEREQUESTS.md als IN BEOBACHTUNG stehen. Die
Autoren-Docs dieser Runde (STIMMEN.md neu, SPEC/CHARACTERS-Anpassungen,
CR 25-27) fahren mit diesem Commit ein.

Verifiziert mit einer Regressions-Sonde (5/5: Kind-Timer aktiv, Wechsel mit
stehender Absage sauber, Dialog endet still bei toten Sprechern, 15 weitere
schnelle Wechsel) und einem Boot-Check ueber 13 Szenen; Sonden vor dem Commit
geloescht.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 20:20:45 +02:00

93 lines
3.4 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).
const REFUSAL_TEXT := "Laut Fahrplan gerade geschlossen."
const REFUSAL_SECONDS := 2.2
const REFUSAL_COLOR := Color(1.0, 0.55, 0.4, 1.0)
static var _pending_spawn_name := ""
@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.
func _ready() -> void:
body_entered.connect(_on_body_entered)
## 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 = 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)