From 4cff3f14e12f816d19fbd95baa42745519b0469e Mon Sep 17 00:00:00 2001 From: danny Date: Tue, 28 Jul 2026 19:36:22 +0200 Subject: [PATCH] CR 33b: Praesentation als eigene Szene flight_field.tscn Loest die Praesentation aus dem alten Dreschen-Set-Piece heraus in eine eigene Szene am Kopf des Gauntlets (Kanon: FLIGHT_FIELD.md). Der Gauntlet-EndTrigger zeigt jetzt hierher statt auf hatching_grounds. - Greybox-Talmulde mit mittigem Feldweg, Drachen-Halbkreis (Muster _make_dragon aus dem Gauntlet, groesser/zahlreicher, im Code gebaut). - Kontrollgesperrte Marsch-Koroutine (Muster _run_presentation), mit gescriptetem Exekutions-Beat: ein Grauer bricht aus dem Glied und faellt. Staffel-Immunitaet ist strukturell hart - die Sequenz ist rein gescriptet, kein Zufallssystem beteiligt. - praesentation_done schaltet die Tuer "Weiter ins Tal" frei; bei Wiedereintritt steht sie sofort offen, keine Wiederholung. Verifikation: Headless-Probe 13/13 (Tuer-Gating, Exekutions-Beat, Wiedereintritt, EndTrigger-Umhaengung), Boot-Check beider Szenen 0 Fehler. Co-Authored-By: Claude Opus 4.8 --- docs/CHANGEREQUESTS.md | 21 +--- scenes/flight_field/flight_field.tscn | 140 +++++++++++++++++++++++ scenes/gauntlet/gauntlet.tscn | 2 +- scripts/gameplay/flight_field.gd | 154 ++++++++++++++++++++++++++ 4 files changed, 296 insertions(+), 21 deletions(-) create mode 100644 scenes/flight_field/flight_field.tscn create mode 100644 scripts/gameplay/flight_field.gd diff --git a/docs/CHANGEREQUESTS.md b/docs/CHANGEREQUESTS.md index 08fc20c..ff89720 100644 --- a/docs/CHANGEREQUESTS.md +++ b/docs/CHANGEREQUESTS.md @@ -17,26 +17,7 @@ ### 33a. Gauntlet: Training vs. Ernstlauf — ✅ ERLEDIGT (2026-07-23, Commit s. DONE) -### 33b. Präsentation — neue Szene `flight_field.tscn` -- Gauntlet-`EndTrigger` (`target_scene_path`) von `hatching_grounds.tscn` auf - `flight_field.tscn` umhängen; Label „Zur Präsentation" bleibt korrekt - (Kanon: Flugfeld liegt am Kopf des Gauntlets, FLIGHT_FIELD.md). -- **Greybox:** langgestreckte Talmulde (Boden-Box, drei Seiten Fels-Boxen, - vierte = Abstieg zum Gauntlet), mittiger „Feldweg" als schmale Marschroute, - Halbkreis aus Drachen-Silhouetten (bestehende `_make_dragon()`-Funktion aus - dem Gauntlet-Code wiederverwenden, größer/zahlreicher). -- **Ablauf:** kontrollgesperrte Marsch-Sequenz (Muster der bestehenden - `_run_presentation()`-Koroutine aus `hatching_grounds.gd`, hierher - verlegt). **Niemand aus Tyrveils eigener Staffel stirbt** (feste Regel). - Aus benachbarten Staffeln: einzelne Ambient-Schreie (nicht sichtbar). Ein - gescripteter Schock-Beat: ein „Grauer" stolpert/zittert, wird sofort von - einem Drachen exekutiert, Formation muss (Kontrolle gesperrt) - weitermarschieren. -- `praesentation_done`-Flag (existiert bereits) schaltet danach die Tür - „Weiter ins Tal" frei. -- **Akzeptanz:** Präsentation läuft als eigene, einmalige Sequenz vor dem - Dreschen; Tyrveils Staffel-Kameraden überleben garantiert; der - Exekutions-Beat ist sichtbar, aber steuerungsgesperrt. +### 33b. Präsentation — neue Szene `flight_field.tscn` — ✅ ERLEDIGT (2026-07-28, Commit s. DONE) ### 33c. Dreschen — neue Szene `dragon_vale.tscn` - **Vale/Tal-Auflösung (entschieden, s. ORTE.md/THE_VALE.md):** Ein Tal, zwei diff --git a/scenes/flight_field/flight_field.tscn b/scenes/flight_field/flight_field.tscn new file mode 100644 index 0000000..af39f8c --- /dev/null +++ b/scenes/flight_field/flight_field.tscn @@ -0,0 +1,140 @@ +[gd_scene load_steps=21 format=3] + +[ext_resource type="Script" path="res://scripts/gameplay/flight_field.gd" id="1_field"] +[ext_resource type="PackedScene" path="res://scenes/player.tscn" id="2_player"] +[ext_resource type="PackedScene" path="res://scenes/ui/debug_overlay.tscn" id="3_debug"] +[ext_resource type="Script" path="res://scripts/gameplay/zone_trigger.gd" id="4_zone"] + +[sub_resource type="ProceduralSkyMaterial" id="ProceduralSkyMaterial_sky"] +sky_horizon_color = Color(0.64625, 0.65575, 0.67075, 1) +ground_horizon_color = Color(0.64625, 0.65575, 0.67075, 1) + +[sub_resource type="Sky" id="Sky_sky"] +sky_material = SubResource("ProceduralSkyMaterial_sky") + +[sub_resource type="Environment" id="Environment_env"] +background_mode = 2 +sky = SubResource("Sky_sky") +tonemap_mode = 2 + +[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_ground"] +albedo_color = Color(0.32, 0.31, 0.29, 1) + +[sub_resource type="BoxShape3D" id="BoxShape3D_ground"] +size = Vector3(24, 1, 46) + +[sub_resource type="BoxMesh" id="BoxMesh_ground"] +material = SubResource("StandardMaterial3D_ground") +size = Vector3(24, 1, 46) + +[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_path"] +albedo_color = Color(0.46, 0.43, 0.33, 1) + +[sub_resource type="BoxMesh" id="BoxMesh_path"] +material = SubResource("StandardMaterial3D_path") +size = Vector3(3, 0.1, 40) + +[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_rock"] +albedo_color = Color(0.36, 0.34, 0.33, 1) + +[sub_resource type="BoxShape3D" id="BoxShape3D_wall_long"] +size = Vector3(1.5, 8, 46) + +[sub_resource type="BoxMesh" id="BoxMesh_wall_long"] +material = SubResource("StandardMaterial3D_rock") +size = Vector3(1.5, 8, 46) + +[sub_resource type="BoxShape3D" id="BoxShape3D_wall_far"] +size = Vector3(24, 8, 1.5) + +[sub_resource type="BoxMesh" id="BoxMesh_wall_far"] +material = SubResource("StandardMaterial3D_rock") +size = Vector3(24, 8, 1.5) + +[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_trigger"] +transparency = 1 +albedo_color = Color(0.3, 0.8, 1, 0.35) + +[sub_resource type="BoxShape3D" id="BoxShape3D_trigger"] +size = Vector3(2, 2, 2) + +[sub_resource type="BoxMesh" id="BoxMesh_trigger"] +material = SubResource("StandardMaterial3D_trigger") +size = Vector3(2, 2, 2) + +[node name="FlightField" type="Node3D"] +script = ExtResource("1_field") + +[node name="WorldEnvironment" type="WorldEnvironment" parent="."] +environment = SubResource("Environment_env") + +[node name="Sun" type="DirectionalLight3D" parent="."] +transform = Transform3D(0.866025, 0.383022, -0.321394, 0, 0.642788, 0.766044, 0.5, -0.663414, 0.55667, 0, 12, 0) +shadow_enabled = true + +[node name="Ground" type="StaticBody3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, -0.5, 0) + +[node name="CollisionShape3D" type="CollisionShape3D" parent="Ground"] +shape = SubResource("BoxShape3D_ground") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="Ground"] +mesh = SubResource("BoxMesh_ground") + +[node name="Feldweg" type="MeshInstance3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.05, 0) +mesh = SubResource("BoxMesh_path") + +[node name="WallWest" type="StaticBody3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, -9, 3.5, 0) + +[node name="CollisionShape3D" type="CollisionShape3D" parent="WallWest"] +shape = SubResource("BoxShape3D_wall_long") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="WallWest"] +mesh = SubResource("BoxMesh_wall_long") + +[node name="WallEast" type="StaticBody3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 9, 3.5, 0) + +[node name="CollisionShape3D" type="CollisionShape3D" parent="WallEast"] +shape = SubResource("BoxShape3D_wall_long") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="WallEast"] +mesh = SubResource("BoxMesh_wall_long") + +[node name="WallFar" type="StaticBody3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 3.5, -23) + +[node name="CollisionShape3D" type="CollisionShape3D" parent="WallFar"] +shape = SubResource("BoxShape3D_wall_far") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="WallFar"] +mesh = SubResource("BoxMesh_wall_far") + +[node name="ValeTrigger" type="Area3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 1, -20) +collision_layer = 0 +collision_mask = 2 +monitoring = false +script = ExtResource("4_zone") +target_scene_path = "res://scenes/vale/dragon_vale.tscn" +target_spawn_name = "FromFlightField" + +[node name="CollisionShape3D" type="CollisionShape3D" parent="ValeTrigger"] +shape = SubResource("BoxShape3D_trigger") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="ValeTrigger"] +mesh = SubResource("BoxMesh_trigger") + +[node name="Label3D" type="Label3D" parent="ValeTrigger"] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 1.6, 0) +billboard = 1 +text = "Weiter ins Tal" +font_size = 40 +outline_size = 12 + +[node name="Player" parent="." instance=ExtResource("2_player")] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.1, 18) + +[node name="DebugOverlay" parent="." instance=ExtResource("3_debug")] diff --git a/scenes/gauntlet/gauntlet.tscn b/scenes/gauntlet/gauntlet.tscn index 9ad8aa2..aba7764 100644 --- a/scenes/gauntlet/gauntlet.tscn +++ b/scenes/gauntlet/gauntlet.tscn @@ -215,7 +215,7 @@ transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 14.5, 37.5, -0.6) collision_layer = 0 collision_mask = 2 script = ExtResource("4_zone") -target_scene_path = "res://scenes/hatching/hatching_grounds.tscn" +target_scene_path = "res://scenes/flight_field/flight_field.tscn" [node name="CollisionShape3D" type="CollisionShape3D" parent="EndTrigger"] shape = SubResource("BoxShape3D_trigger") diff --git a/scripts/gameplay/flight_field.gd b/scripts/gameplay/flight_field.gd new file mode 100644 index 0000000..ce35148 --- /dev/null +++ b/scripts/gameplay/flight_field.gd @@ -0,0 +1,154 @@ +extends Node3D +## Ablauf-Steuerung der Präsentation (Phase 5, CR 33b — aus dem alten +## Dreschen-Set-Piece herausgelöst). +## +## Das Flugfeld liegt laut Kanon am Kopf des Gauntlets (FLIGHT_FIELD.md): +## Wer den Gauntlet besteht, tritt hier zur Präsentation an, ehe es +## „hinab ins Tal" zum Dreschen geht. Kein Parcours — eine kurze, +## kontrollgesperrte Sequenz mit Kamera-Schwenk (Muster der früheren +## `_run_presentation()`-Koroutine aus `hatching_grounds.gd`, hierher +## verlegt): Die Erstjahre schreiten die Reihe der Drachen-Silhouetten +## ab (Erzähltext über die Sprechblase), danach öffnet das Flag +## `praesentation_done` die Tür „Weiter ins Tal". +## +## **Staffel-Immunität ist hart (CR 33b):** Niemand aus Tyrveils eigener +## Staffel stirbt — und das ist hier keine gewürfelte Ausnahme, sondern +## strukturell garantiert, weil die ganze Sequenz gescriptet ist und +## KEIN Zufallssystem berührt. Aus fremden Staffeln fällt ein einzelner +## Ambient-Schrei (nicht sichtbar). Der eine sichtbare Schock-Beat ist +## fest gescriptet: Ein „Grauer" zwei Reihen weiter bricht aus dem Glied, +## ein Drache senkt den Schädel, die Silhouette fällt — und die Formation +## marschiert (Kontrolle gesperrt) weiter. +## +## Die Drachen-Silhouetten am Grat baut `_make_dragon()` im Code (größer +## und zahlreicher als die Gauntlet-Variante, aus der das Muster stammt), +## der „Graue" ist eine graue Kapsel in der Formation, die der +## Exekutions-Beat fallen lässt. + +const PRESENTATION_FLAG := "praesentation_done" +const PRESENTATION_LINES: Array[String] = [ + "Das Feld liegt still. Erstjahre in Reihen, Drachen auf den Graten darüber — die Präsentation. Noch wählen sie nicht. Sie sehen hin.", + "Ihr geht die Reihe ab. Langsam. Nicht stolpern, nicht starren. Wren atmet neben dir viel zu schnell — aber er geht.", + "Weiter vorn, aus einer fremden Staffel, ein Schrei — kurz, dann nichts. Niemand dreht den Kopf. Niemand darf.", + "Ein Grauer, zwei Reihen neben dir, fängt an zu zittern. Er bricht aus dem Glied. Ein Schädel senkt sich aus dem Grat — es ist vorbei, ehe der Laut euch erreicht. Die Formation geht weiter. Du gehst weiter.", + "Ein Blick folgt euch, länger als allen anderen. Aus dem Winkel, wo die Schatten am dichtesten stehen.", + "Dann ist die Reihe zu Ende. Kein Urteil, kein Zeichen — nur der Weg, der jetzt hinab ins Tal führt. Das Dreschen wartet.", +] +const EXECUTION_LINE_INDEX := 3 +const DRAGON_COLOR := Color(0.18, 0.14, 0.16) +const DRAGON_SCALE := 1.8 +const GREY_COLOR := Color(0.55, 0.55, 0.58) +const FALL_SECONDS := 0.5 + +@onready var _vale_trigger: Area3D = $ValeTrigger + +var _grauer: Node3D + + +## Baut die Drachen-Silhouetten und den „Grauen", spielt den +## Kamera-Schwenk und lässt beim ersten Besuch die Präsentation laufen; +## war sie schon einmal gesehen, steht die Tür ins Tal sofort offen. +func _ready() -> void: + _build_dragons() + _grauer = _make_grauer(Vector3(3.0, 0.0, 11.0)) + add_child(_grauer) + var player := get_tree().get_first_node_in_group("player") + if player != null: + player.play_camera_pan() + if bool(GameState.get_story_flag(PRESENTATION_FLAG, false)): + _arm_vale_trigger() + return + _vale_trigger.monitoring = false + _run_presentation.call_deferred() + + +## Spielt die Präsentation als Coroutine: kontrollgesperrter Marsch mit +## Erzähltext, dazwischen der gescriptete Exekutions-Beat; danach öffnet +## sich die Tür ins Tal. +func _run_presentation() -> void: + await get_tree().create_timer(0.6).timeout + var player := get_tree().get_first_node_in_group("player") + if player == null or DialogueSystem.is_dialogue_active: + return + player.set_control_locked(true) + var player_bubble: Node3D = player.get_node("SpeechBubble") + for i in PRESENTATION_LINES.size(): + if i == EXECUTION_LINE_INDEX: + _drop_grauer() + await _say(player_bubble, PRESENTATION_LINES[i]) + GameState.set_story_flag(PRESENTATION_FLAG, true) + _arm_vale_trigger() + player.set_control_locked(false) + + +## Lässt die Silhouette des „Grauen" fallen und gibt sie danach frei — +## der sichtbare, aber steuerungsgesperrte Exekutions-Beat. +func _drop_grauer() -> void: + if _grauer == null: + return + var target := _grauer.position + Vector3(0.0, -2.2, 0.0) + var tween := create_tween() + tween.tween_property(_grauer, "position", target, FALL_SECONDS).set_trans(Tween.TRANS_QUAD).set_ease(Tween.EASE_IN) + tween.tween_callback(_grauer.queue_free) + + +## Öffnet die Tür „Weiter ins Tal" (erst nach der Präsentation). +func _arm_vale_trigger() -> void: + _vale_trigger.set_deferred("monitoring", true) + + +## Zeigt eine Zeile über der Blase und wartet ihr Ende ab. +func _say(bubble: Node3D, text: String) -> void: + bubble.show_line(text) + await bubble.line_finished + + +## Verteilt die Drachen-Silhouetten auf beiden Graten, dem Feldweg +## zugewandt, plus ein Paar am Talschluss — der Halbkreis, der die +## Präsentation beobachtet. +func _build_dragons() -> void: + for z in [12.0, 6.0, 0.0, -6.0, -12.0]: + add_child(_make_dragon(Vector3(-7.5, 4.0, z), PI / 2.0)) + add_child(_make_dragon(Vector3(7.5, 4.0, z), -PI / 2.0)) + add_child(_make_dragon(Vector3(-4.0, 0.0, -17.0), 0.0)) + add_child(_make_dragon(Vector3(4.0, 0.0, -17.0), 0.0)) + + +## Baut eine Drachen-Silhouette (Muster aus gauntlet.gd, hier größer); +## `facing` dreht sie zum Feldweg. +func _make_dragon(spot: Vector3, facing: float) -> Node3D: + var dragon := Node3D.new() + dragon.position = spot + dragon.rotation.y = facing + dragon.add_child(_make_mesh(Vector3(1.6, 1.4, 2.8) * DRAGON_SCALE, Vector3(0, 0.7, 0) * DRAGON_SCALE, DRAGON_COLOR)) + dragon.add_child(_make_mesh(Vector3(0.5, 1.6, 0.5) * DRAGON_SCALE, Vector3(0, 1.8, 1.2) * DRAGON_SCALE, DRAGON_COLOR)) + return dragon + + +## Baut die graue Kadetten-Silhouette in der Formation. +func _make_grauer(spot: Vector3) -> Node3D: + var grauer := Node3D.new() + grauer.position = spot + Vector3(0, 0.9, 0) + var mesh_instance := MeshInstance3D.new() + var mesh := CapsuleMesh.new() + mesh.radius = 0.4 + mesh.height = 1.8 + var material := StandardMaterial3D.new() + material.albedo_color = GREY_COLOR + mesh.material = material + mesh_instance.mesh = mesh + grauer.add_child(mesh_instance) + return grauer + + +## Baut ein reines Greybox-Mesh. +func _make_mesh(size: Vector3, position_offset: Vector3, color: Color) -> MeshInstance3D: + var mesh_instance := MeshInstance3D.new() + var mesh := BoxMesh.new() + mesh.size = size + var material := StandardMaterial3D.new() + material.albedo_color = color + mesh.material = material + mesh_instance.mesh = mesh + mesh_instance.position = position_offset + return mesh_instance