windgeschworen/scripts/gameplay/page_spawner.gd
danny 6ccc94cfda CR 12: Blaetter jagen — verlorene Seiten einfangen
Lose Heftblaetter treiben im Wind ueber den Hof: gewuerfelte Driftrichtung,
Wippen, Trudeln, und am Rand des Treibkreises setzen sie sich auf der
Gegenseite neu an. Die Flughoehe wird zwischen 0,5 und 2,3 Metern gewuerfelt —
tiefe Blaetter erwischt man im Slide, hohe im Sprung. Gefangen wird ohne
Interaktionstaste, allein durch Beruehrung.

Der Spawner streut pro Tag drei Blaetter aus: erst die festen
Schluessel-Seiten ab ihrem min_day, dann gewichtet gezogener Rest. Gefangene
Seiten kommen nie wieder (GameState.caught_pages, im Spielstand).

Vier Fund-Typen: wahrheit legt ein Fragment aufs Muster-Board, notiz hebt
einen Lexicon-Fachzaehler und gibt Verstand, vater ist der seltene Fund,
flavor traegt nur die Zeile.

Kanon-Entscheidung (STORY vor CR): Wahrheit 2 ist anvertraute Wahrheit und
kommt von Mira, nicht vom Wind. Die Vater-Seiten enthuellen deshalb nichts —
sie sind seine Handschrift und liegen unter vater_seite_* auf einer eigenen
Lexicon-Seite statt auf dem Muster-Board; sie ziehen Richtung Herz.

Verifiziert mit dev_cr12_probe (25/25) und einem Boot-Check ueber acht
Szenen; Sonde vor dem Commit geloescht.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-20 20:07:27 +02:00

126 lines
4.2 KiB
GDScript

extends Node3D
## Spawner für „Blätter jagen" (CR 12).
##
## Verteilt beim Szenen-Start lose Heftblätter aus
## data/pages/loose_pages.json im Umkreis um sich. Zuerst kommen die
## festen Schlüssel-Seiten dran (is_fixed, ab ihrem min_day, solange
## ungefangen) — so sind die Story-tragenden Fragmente garantiert
## erreichbar; die restlichen Plätze zieht der Spawner gewichtet aus dem
## übrigen Pool. Schon gefangene Seiten kommen nie wieder.
##
## Die Auswertung beim Fangen richtet sich nach dem Fund-Typ:
## - wahrheit: Fragment aufs Muster-Board (Story-Flag w1_fragment_*, CR 2)
## - notiz: Fach-Zähler des Lexicons +1 und Verstand +1 (CR 4)
## - vater: seltener Erinnerungsfund (Story-Flag vater_seite_*) und
## ein Schritt Richtung Herz — Wahrheit 2 selbst bleibt
## anvertraute Wahrheit und kommt von Mira, nicht vom Wind
## - flavor: nur die Fundzeile
const PAGE_SCENE := preload("res://scenes/props/loose_page.tscn")
const PAGES_PATH := "res://data/pages/loose_pages.json"
@export var pages_per_day := 3
@export var drift_radius := 18.0
var _pages: Array = []
var _spawned: Array[Node3D] = []
## Lädt den Seiten-Pool und streut die Blätter des heutigen Tages aus.
func _ready() -> void:
var file := FileAccess.open(PAGES_PATH, FileAccess.READ)
if file == null:
push_error("Seiten-Daten nicht lesbar: %s" % PAGES_PATH)
return
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if not (parsed is Dictionary) or not (parsed.get("pages") is Array):
push_error("Seiten-Daten sind ungültig: %s" % PAGES_PATH)
return
_pages = parsed["pages"]
for page in pick_pages_for_today():
_spawn_page(page)
## Wählt die Seiten des heutigen Tages: feste Schlüssel-Seiten zuerst,
## der Rest gewichtet gezogen. Ohne Seiteneffekte, damit Tests die
## Auswahl prüfen können.
func pick_pages_for_today() -> Array:
var chosen: Array = []
var pool: Array = []
for page in _pages:
if not _is_available(page):
continue
if bool(page.get("is_fixed", false)):
chosen.append(page)
else:
pool.append(page)
chosen = chosen.slice(0, pages_per_day)
while chosen.size() < pages_per_day and not pool.is_empty():
var drawn := _draw_weighted(pool)
if drawn.is_empty():
break
chosen.append(drawn)
pool.erase(drawn)
return chosen
## Anzahl gerade treibender Blätter (für Tests/Overlay).
func floating_page_count() -> int:
var count := 0
for page in _spawned:
if is_instance_valid(page):
count += 1
return count
## Wertet einen Fund nach seinem Typ aus und merkt die Seite als
## gefangen, damit sie nicht wiederkehrt.
func resolve_catch(page: Dictionary) -> void:
var page_id := str(page.get("id", ""))
if page_id.is_empty() or GameState.has_caught_page(page_id):
return
GameState.mark_page_caught(page_id)
match str(page.get("type", "flavor")):
"wahrheit":
GameState.set_story_flag(str(page.get("fragment_flag", "")), str(page.get("fragment_text", "")))
"notiz":
var counter := str(page.get("subject_flag", ""))
if not counter.is_empty():
GameState.set_story_flag(counter, int(GameState.get_story_flag(counter, 0)) + 1)
GameState.increase_stat("intellect", 1)
"vater":
GameState.set_story_flag(str(page.get("keepsake_flag", "")), str(page.get("keepsake_text", "")))
GameState.shift_blade_heart_tone(-1)
GameState.shift_humanity(1)
## Prüft, ob eine Seite heute überhaupt auftauchen darf.
func _is_available(page: Dictionary) -> bool:
if GameState.has_caught_page(str(page.get("id", ""))):
return false
return TimeSystem.day_count >= int(page.get("min_day", 1))
## Zieht eine Seite gewichtet aus dem Pool (weight, Standard 1).
func _draw_weighted(pool: Array) -> Dictionary:
var total := 0
for page in pool:
total += maxi(int(page.get("weight", 1)), 1)
if total <= 0:
return {}
var roll := randi_range(1, total)
for page in pool:
roll -= maxi(int(page.get("weight", 1)), 1)
if roll <= 0:
return page
return pool[pool.size() - 1]
## Setzt ein Blatt in den Wind und hängt die Auswertung an.
func _spawn_page(page: Dictionary) -> void:
var leaf: Node3D = PAGE_SCENE.instantiate()
add_child(leaf)
leaf.setup(page, global_position, drift_radius)
leaf.caught.connect(resolve_catch)
_spawned.append(leaf)