windgeschworen/scripts/gameplay/loose_page.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

98 lines
3.1 KiB
GDScript

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)