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)