windgeschworen/scripts/gameplay/page_spawner.gd
danny a6653ae6f2 CR 21: Blaetter jagen wird zur echten Hatz
Die Blaetter trieben bisher in konstanter Richtung und reagierten nicht auf
den Spieler — ein bewegtes Pickup, keine Jagd. Jetzt hat das Blatt drei
Flugzustaende: Treiben, Boee, Sacken. Kommt der Spieler nah, reisst eine Boee
es weg — fort von ihm, mit seitlichem Ausschlag, schneller, hoeher und
sichtbar heftiger trudelnd. Danach sackt es ab, tiefer und deutlich langsamer
als die Grunddrift. Das ist das Fenster, in dem Slide, Sprint und Sprung
zugreifen.

Die Einholbarkeit ist konstruiert, nicht gehofft. gust_speed liegt unter der
Sprint-Geschwindigkeit des Spielers, das Blatt ermuedet mit jeder Boee und
gibt nach fuenf auf, und die Boeen-Sperre deckt das Sackenfenster
vollstaendig ab. Alle Werte stehen im flight-Block von loose_pages.json, die
Regel steht als balance_note daneben.

Balance in zwei Schritten gefunden: die erste Fassung war zu zahm, die
simulierte Jagd endete nach 1,4 s mit einer einzigen Boee. Beim Nachziehen
fiel auf, dass die Abklingzeit mitten im Sacken ablief und das sichere
Fenster auf 0,45 s zusammenschrumpfte — seitdem deckt die Sperre das ganze
Fenster ab. Jetzt dauert die Jagd 7,4 Sekunden ueber drei Boeen und endet
sicher.

Fund-Typen, Gewichte, feste Schluessel-Seiten und alle Belohnungen aus CR 12
bleiben unveraendert.

Verifiziert mit dev_cr21_probe (24/24), darunter eine simulierte Jagd, in der
ein sprintender Verfolger das Blatt nachweislich einholt, und einem
Boot-Check ueber acht Szenen; Sonde vor dem Commit geloescht.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-21 19:13:58 +02:00

128 lines
4.3 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 _flight: Dictionary = {}
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"]
_flight = parsed.get("flight", {})
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, _flight)
leaf.caught.connect(resolve_catch)
_spawned.append(leaf)