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>
This commit is contained in:
danny 2026-07-20 20:07:27 +02:00
parent 8c85850fe3
commit 6ccc94cfda
12 changed files with 466 additions and 18 deletions

View file

@ -0,0 +1,98 @@
extends Area3D
## Ein loses Heftblatt, das im Wind über den Hof treibt (CR 12).
##
## Das Blatt driftet in Windrichtung, wippt dabei auf und ab und
## trudelt um die eigene Achse — gefangen wird es allein mit dem
## bestehenden Movement (Laufen, Sprint, Slide, Sprung), ohne
## Interaktions-Taste. Die Flughöhe wird beim Spawn gewürfelt: tiefe
## Blätter erwischt man im Slide, hohe im Sprung.
##
## Verlässt es den Wirkungsradius, setzt es sich auf der Gegenseite neu
## an, damit man es weiter jagen kann. Beim Fangen meldet es sich per
## caught mit seinen Daten und zeigt die Fundzeile über der Sprechblase;
## die Auswertung macht der PageSpawner.
signal caught(page: Dictionary)
const DRIFT_SPEED_MIN := 2.2
const DRIFT_SPEED_MAX := 3.6
const BOB_AMPLITUDE := 0.35
const BOB_SPEED_MIN := 1.4
const BOB_SPEED_MAX := 2.6
const TUMBLE_SPEED := 2.0
const HEIGHT_MIN := 0.5
const HEIGHT_MAX := 2.3
var _page: Dictionary = {}
var _drift := Vector3.FORWARD
var _drift_speed := DRIFT_SPEED_MIN
var _bob_speed := BOB_SPEED_MIN
var _bob_phase := 0.0
var _base_height := 1.2
var _center := Vector3.ZERO
var _radius := 20.0
var _is_caught := false
@onready var _mesh: Node3D = $MeshInstance3D
@onready var _bubble: SpeechBubble = $SpeechBubble
## Verbindet den Fang-Trigger.
func _ready() -> void:
body_entered.connect(_on_body_entered)
## Richtet das Blatt ein: Daten, Treibkreis und gewürfelte Flugbahn.
func setup(page: Dictionary, center: Vector3, radius: float) -> void:
_page = page
_center = center
_radius = radius
_drift = Vector3(randf_range(-1.0, 1.0), 0.0, randf_range(-1.0, 1.0)).normalized()
_drift_speed = randf_range(DRIFT_SPEED_MIN, DRIFT_SPEED_MAX)
_bob_speed = randf_range(BOB_SPEED_MIN, BOB_SPEED_MAX)
_bob_phase = randf_range(0.0, TAU)
_base_height = randf_range(HEIGHT_MIN, HEIGHT_MAX)
global_position = _center + Vector3(
randf_range(-_radius, _radius),
_base_height,
randf_range(-_radius, _radius)
)
## Die Daten des Blattes (für Spawner und Tests).
func get_page() -> Dictionary:
return _page
## Treibt das Blatt, lässt es wippen und trudeln und setzt es am
## gegenüberliegenden Rand neu an, wenn es den Kreis verlässt.
func _process(delta: float) -> void:
if _is_caught:
return
global_position += _drift * _drift_speed * delta
_bob_phase += _bob_speed * delta
global_position.y = _base_height + sin(_bob_phase) * BOB_AMPLITUDE
_mesh.rotate_y(TUMBLE_SPEED * delta)
_mesh.rotation.x = sin(_bob_phase * 0.7) * 0.6
var offset := global_position - _center
offset.y = 0.0
if offset.length() > _radius:
var wrapped := _center - offset.normalized() * _radius
global_position = Vector3(wrapped.x, global_position.y, wrapped.z)
## Fängt das Blatt, sobald der Spieler es berührt: Mesh weg, Fundzeile
## einblenden, melden und nach der Zeile verschwinden.
func _on_body_entered(body: Node3D) -> void:
if _is_caught or not body.is_in_group("player"):
return
_is_caught = true
_mesh.visible = false
monitoring = false
caught.emit(_page)
var line := str(_page.get("catch_line", ""))
if line.is_empty():
queue_free()
return
_bubble.line_finished.connect(queue_free)
_bubble.show_line(line)

View file

@ -0,0 +1 @@
uid://xwqdwxqbqe73

View file

@ -0,0 +1,126 @@
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)

View file

@ -0,0 +1 @@
uid://c0sigservym80