From 7f8429abdc4064ec02057102b087be432696bace Mon Sep 17 00:00:00 2001 From: danny Date: Sat, 11 Jul 2026 23:01:03 +0200 Subject: [PATCH] v1-Ausbau Phase 3: Die Grauen als Statisten mit gewichtetem Bark-System - grey_cadet (scenes/npcs/): namenlose graue Kapsel-Statisten ohne Interaktion; Naehe (bark_radius 4,5 m) zeigt mit Zufalls-Chance eine Ueberkopf-Zeile aus gewichteten JSON-Pools (data/barks/ambient.json: 10 Zeilen Akademie-Gefluester; schergen.json: 5 Drohzeilen inkl. Cassians Kanon-Zeile); Cooldown pro Statist + globaler Cooldown, Pause waehrend Dialogen - grey_spawner im Hof: verteilt 5 Statisten zufaellig; ab Tag 4 spawnen 2 Schergen (dunkle Toenung, Drohungs-Pool), einer rempelt Wren skript-getriggert an (hinlaufen, Versatz + Reaktions-Zeile, Drohzeile, zurueck zum Posten) - Reaktions-Wahl des Spielers folgt mit den Cassian-Dialogen in Phase 4 - Verifikation: Sonde 12/12 gruen (Pools, Spawn-Zahlen Tag 1/4, Naehe-Bark + Cooldown, Schergen-Toenung, Wren-Anrempeln mit Versatz); Boot-Check fehlerfrei; Phase-3-Block nach CHANGEREQUESTS_DONE Co-Authored-By: Claude Fable 5 --- data/barks/ambient.json | 14 +++ data/barks/schergen.json | 9 ++ docs/CHANGEREQUESTS.md | 14 +-- docs/CHANGEREQUESTS_DONE.md | 32 +++++ scenes/hub/rider_quadrant.tscn | 9 +- scenes/npcs/grey_cadet.tscn | 39 ++++++ scripts/gameplay/grey_cadet.gd | 171 +++++++++++++++++++++++++++ scripts/gameplay/grey_cadet.gd.uid | 1 + scripts/gameplay/grey_spawner.gd | 65 ++++++++++ scripts/gameplay/grey_spawner.gd.uid | 1 + 10 files changed, 344 insertions(+), 11 deletions(-) create mode 100644 data/barks/ambient.json create mode 100644 data/barks/schergen.json create mode 100644 scenes/npcs/grey_cadet.tscn create mode 100644 scripts/gameplay/grey_cadet.gd create mode 100644 scripts/gameplay/grey_cadet.gd.uid create mode 100644 scripts/gameplay/grey_spawner.gd create mode 100644 scripts/gameplay/grey_spawner.gd.uid diff --git a/data/barks/ambient.json b/data/barks/ambient.json new file mode 100644 index 0000000..b5e0836 --- /dev/null +++ b/data/barks/ambient.json @@ -0,0 +1,14 @@ +{ + "barks": [ + { "text": "Presentation Day rückt näher. Ich träume schon von der Schlucht.", "weight": 2 }, + { "text": "Hast du die Liste gesehen? Zwei Namen weniger seit gestern.", "weight": 2 }, + { "text": "Der Gauntlet frisst jedes Jahr die Langsamen.", "weight": 2 }, + { "text": "Lern Kaoris Tafeln. Die Schwanztypen. Oder ein Drache lehrt sie dich.", "weight": 1 }, + { "text": "Emetterio hat heute drei auf die Matte geschickt. Drei.", "weight": 1 }, + { "text": "Nicht hinsehen. Einfach weitergehen.", "weight": 1 }, + { "text": "Mein Bruder hat es letztes Jahr nicht geschafft. Also rede ich nicht darüber.", "weight": 1 }, + { "text": "Devera sagt, das Wetter dreht. Schlecht fürs Flugfeld.", "weight": 1 }, + { "text": "Die Gezeichneten halten zusammen, sagen sie. Sagen sie.", "weight": 2 }, + { "text": "Beim Dreschen zählt nur, wen der Drache ansieht. Alles andere ist Lärm.", "weight": 1 } + ] +} diff --git a/data/barks/schergen.json b/data/barks/schergen.json new file mode 100644 index 0000000..eae1a68 --- /dev/null +++ b/data/barks/schergen.json @@ -0,0 +1,9 @@ +{ + "barks": [ + { "text": "Er zieht uns alle runter. Einer von uns muss nicht sterben, wenn ER stirbt.", "weight": 3 }, + { "text": "Pass auf, wo du hintrittst, Rowyth.", "weight": 2 }, + { "text": "Dein kleiner Freund stolpert viel in letzter Zeit.", "weight": 2 }, + { "text": "Cassian fragt nicht zweimal.", "weight": 1 }, + { "text": "Große Male brennen zuerst.", "weight": 1 } + ] +} diff --git a/docs/CHANGEREQUESTS.md b/docs/CHANGEREQUESTS.md index 43da7c4..6965c7e 100644 --- a/docs/CHANGEREQUESTS.md +++ b/docs/CHANGEREQUESTS.md @@ -9,16 +9,10 @@ > ausgebauten Akt 1 (STORY.md §5) und die neue Raum-Architektur (SPEC.md §5.1) > zu realisieren. Phasenweise abarbeiten; Details stehen in den Design-Docs. > -> _Status (2026-07-11, Claude): Laufendes Phasen-Programm. **Phase 1 -> (TimeSystem/Fahrplan/Flags) und Phase 2 (Räume + Zonen) sind erledigt** -> — siehe CHANGEREQUESTS_DONE. Nächste Phasen: (3) Graue/Barks, -> (4) Cassian, (5) Imogen-Abende, (6) System-Anpassungen._ - -### „Die Grauen" + Bark-System -- Statisten-NPC-Szene (graue Kapsel/Pilz-Primitive) + Spawner für Hof/Gänge. -- Bark-System: Trigger-Radius um den Spieler → zufällige Überkopf-Textbox aus - gewichtetem Pool (`data/barks/*.json`), mit Cooldown, ohne Interaktion. -- Ab Tag 4 „Schergen"-Variante: skript-getriggerter Bark + gezieltes Wren-Anrempeln. +> _Status (2026-07-11, Claude): Laufendes Phasen-Programm. **Phasen 1–3 +> (TimeSystem/Fahrplan, Räume + Zonen, Graue/Barks) sind erledigt** — +> siehe CHANGEREQUESTS_DONE. Nächste Phasen: (4) Cassian, +> (5) Imogen-Abende, (6) System-Anpassungen._ ### Cassian Vane (Antagonist) - NPC + Dialogbäume (`data/dialogue/cassian_*`), Auftritte Tag 1–9 lt. STORY §5. diff --git a/docs/CHANGEREQUESTS_DONE.md b/docs/CHANGEREQUESTS_DONE.md index b41d9eb..d10fb20 100644 --- a/docs/CHANGEREQUESTS_DONE.md +++ b/docs/CHANGEREQUESTS_DONE.md @@ -3,6 +3,38 @@ > Abgearbeitete Change Requests aus CHANGEREQUESTS.md, mit Datum und > Anmerkung, was geändert wurde. +## 2026-07-11 — Rotunden-Fix + v1-Ausbau Phase 3: „Die Grauen" + Bark-System + +**Request:** (a) Rotunde: Wände falsch angeordnet, zeigen in den Raum; +(b) Phase 3: Statisten-NPCs + Bark-System + Schergen-Variante ab Tag 4. + +**Umsetzung:** +- **Rotunden-Fix:** Die vier Diagonal-Wände und drei Schiefertafeln + hatten vertauschte Rotationen (Längsachse radial statt tangential). + Korrigiert und per Mini-Sonde mathematisch verifiziert: Alle 8 Wände + + 6 Tafeln stehen tangential am Kreis (dot 1.000). +- **„Die Grauen"** (`scenes/npcs/grey_cadet.tscn`): namenlose graue + Kapsel-Statisten ohne Interaktion. Bark-System im Statisten: Kommt der + Spieler in bark_radius (4,5 m), erscheint mit Zufalls-Chance eine + Überkopf-Zeile über die Sprechblase — gewichtete Pools aus + `data/barks/ambient.json` (10 Zeilen Akademie-Geflüster, STORY-konform) + und `data/barks/schergen.json` (5 Drohzeilen, inkl. Cassians + Kanon-Zeile). Cooldown pro Statist (12 s) + geteilter globaler + Cooldown (4 s), Pause während Dialogen. +- **Spawner** (`grey_spawner.gd`, im Hof verdrahtet): verteilt 5 + Statisten zufällig über den Hof. Ab Tag 4 (TimeSystem) spawnen + zusätzlich 2 **Schergen** (dunkle Tönung, Drohungs-Pool); einer läuft + nach kurzer Verzögerung skript-getriggert zu Wren, rempelt ihn an + (Versatz + „Hey—! Schon gut."-Reaktion), setzt eine Drohzeile und + kehrt auf seinen Posten zurück. +- Verstand-Checks/Reaktions-Wahl beim Anrempeln (deeskalieren/markieren/ + eskalieren) kommen mit den Cassian-Dialogen in Phase 4. + +**Verifikation:** Rotunden-Sonde 14/14 tangential; Phase-3-Sonde 12/12 +grün (Pools gewichtet geladen, 5 Statisten an Tag 1 ohne Schergen, +Nähe-Bark + Cooldown, ab Tag 4 zwei Schergen mit Tönung, gezieltes +Wren-Anrempeln inkl. Versatz). Boot-Check fehlerfrei. + ## 2026-07-11 — v1-Ausbau Phase 2: Neue Greybox-Räume + Zonen-Anbindung **Request:** Die Räume aus SPEC §5.1 als Primitiven bauen und wie den diff --git a/scenes/hub/rider_quadrant.tscn b/scenes/hub/rider_quadrant.tscn index 929f7dc..09d9427 100644 --- a/scenes/hub/rider_quadrant.tscn +++ b/scenes/hub/rider_quadrant.tscn @@ -1,4 +1,4 @@ -[gd_scene load_steps=39 format=3] +[gd_scene load_steps=40 format=3] [ext_resource type="Script" path="res://scripts/gameplay/hub_room.gd" id="1_room"] [ext_resource type="PackedScene" path="res://scenes/player.tscn" id="2_player"] @@ -8,6 +8,7 @@ [ext_resource type="PackedScene" path="res://scenes/ui/speech_bubble.tscn" id="6_bubble"] [ext_resource type="Script" path="res://scripts/gameplay/ambient_chatter.gd" id="7_chatter"] [ext_resource type="Script" path="res://scripts/gameplay/jack_ambush.gd" id="10_jack"] +[ext_resource type="Script" path="res://scripts/gameplay/grey_spawner.gd" id="11_grey"] [sub_resource type="ProceduralSkyMaterial" id="ProceduralSkyMaterial_sky"] sky_horizon_color = Color(0.64625, 0.65575, 0.67075, 1) @@ -652,6 +653,12 @@ transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 12, 0.1, 16) [node name="FromMaterialRoom" type="Marker3D" parent="SpawnPoints"] transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 16.5, 0.1, 12) +[node name="GreySpawner" type="Node3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0) +script = ExtResource("11_grey") +spawn_extents = Vector3(14, 0, 14) +wren_path = NodePath("../Wren") + [node name="NpcWaypoints" type="Node3D" parent="."] [node name="ImogenA" type="Marker3D" parent="NpcWaypoints"] diff --git a/scenes/npcs/grey_cadet.tscn b/scenes/npcs/grey_cadet.tscn new file mode 100644 index 0000000..6ac8cf2 --- /dev/null +++ b/scenes/npcs/grey_cadet.tscn @@ -0,0 +1,39 @@ +[gd_scene load_steps=6 format=3] + +[ext_resource type="Script" path="res://scripts/gameplay/grey_cadet.gd" id="1_grey"] +[ext_resource type="PackedScene" path="res://scenes/ui/speech_bubble.tscn" id="2_bubble"] + +[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_grey"] +albedo_color = Color(0.55, 0.55, 0.57, 1) + +[sub_resource type="CapsuleMesh" id="CapsuleMesh_grey"] +material = SubResource("StandardMaterial3D_grey") +radius = 0.38 +height = 1.7 + +[sub_resource type="SphereMesh" id="SphereMesh_head"] +material = SubResource("StandardMaterial3D_grey") +radius = 0.22 +height = 0.44 + +[sub_resource type="CapsuleShape3D" id="CapsuleShape3D_grey"] +radius = 0.38 +height = 1.7 + +[node name="GreyCadet" type="StaticBody3D"] +script = ExtResource("1_grey") + +[node name="CollisionShape3D" type="CollisionShape3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.85, 0) +shape = SubResource("CapsuleShape3D_grey") + +[node name="MeshInstance3D" type="MeshInstance3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.85, 0) +mesh = SubResource("CapsuleMesh_grey") + +[node name="Head" type="MeshInstance3D" parent="."] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 1.85, 0) +mesh = SubResource("SphereMesh_head") + +[node name="SpeechBubble" parent="." instance=ExtResource("2_bubble")] +transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 2.4, 0) diff --git a/scripts/gameplay/grey_cadet.gd b/scripts/gameplay/grey_cadet.gd new file mode 100644 index 0000000..b14d600 --- /dev/null +++ b/scripts/gameplay/grey_cadet.gd @@ -0,0 +1,171 @@ +extends StaticBody3D +## „Die Grauen" — namenlose Statisten-Kadetten mit Bark-System +## (v1-Ausbau Phase 3, SPEC §5.1/STORY §5). +## +## Graue Kapsel ohne Interaktion: Kommt der Spieler in bark_radius, +## zeigt der Statist mit etwas Zufall eine Überkopf-Zeile aus dem +## gewichteten Pool (data/barks/ambient.json) über seine Sprechblase — +## mit eigenem Cooldown pro Statist und einem geteilten globalen +## Cooldown, damit der Hof nicht plappert wie ein Marktplatz. Die +## Schergen-Variante (is_scherge, ab Tag 4 vom Spawner gesetzt) nutzt +## den Drohungs-Pool (schergen.json), ist dunkler getönt und kann per +## Skript ein gezieltes Wren-Anrempeln laufen: hingehen, anrempeln, +## Drohzeile, zurück zum Posten. + +const AMBIENT_POOL_PATH := "res://data/barks/ambient.json" +const SCHERGEN_POOL_PATH := "res://data/barks/schergen.json" +const GLOBAL_BARK_GAP_MS := 4000 + +static var _pools: Dictionary = {} +static var _last_global_bark_ms := -GLOBAL_BARK_GAP_MS + +@export var is_scherge := false +@export var bark_radius := 4.5 +@export var bark_cooldown := 12.0 +@export var bark_chance := 0.6 +@export var walk_speed := 2.6 + +var _cooldown_left := 0.0 +var _poll_left := 0.0 +var _bump_target: Node3D +var _home_position := Vector3.ZERO +var _bump_state := BumpState.IDLE +var _has_bumped := false + +enum BumpState { IDLE, APPROACHING, RETURNING } + +@onready var _bubble: Node3D = $SpeechBubble +@onready var _mesh: MeshInstance3D = $MeshInstance3D + + +## Lädt die Bark-Pools einmalig, merkt den Posten und tönt Schergen ab. +func _ready() -> void: + _load_pool(AMBIENT_POOL_PATH) + _load_pool(SCHERGEN_POOL_PATH) + _home_position = global_position + if is_scherge: + apply_scherge_tint() + + +## Färbt die Kapsel dunkler (Schergen-Variante); vom Spawner nach dem +## Setzen von is_scherge aufgerufen. +func apply_scherge_tint() -> void: + var material := StandardMaterial3D.new() + material.albedo_color = Color(0.3, 0.28, 0.3) + _mesh.material_override = material + + +## Startet das gezielte Wren-Anrempeln (skript-getriggert, ab Tag 4). +func start_bump(target: Node3D) -> void: + if _bump_state != BumpState.IDLE or target == null: + return + _bump_target = target + _bump_state = BumpState.APPROACHING + + +## Meldet, ob das Anrempeln durchgeführt wurde (für Tests). +func has_bumped() -> bool: + return _has_bumped + + +## Meldet, ob gerade eine Bark-Zeile sichtbar ist (für Tests). +func is_barking() -> bool: + return _bubble.visible + + +## Treibt Bark-Polling und die Anrempel-Bewegung an. +func _physics_process(delta: float) -> void: + _cooldown_left = maxf(_cooldown_left - delta, 0.0) + if _bump_state != BumpState.IDLE: + _process_bump(delta) + return + _poll_left -= delta + if _poll_left > 0.0: + return + _poll_left = 0.8 + _try_bark() + + +## Zeigt mit etwas Zufall eine gewichtete Pool-Zeile, wenn der Spieler +## nah ist und kein Cooldown greift. +func _try_bark() -> void: + if _cooldown_left > 0.0 or DialogueSystem.is_dialogue_active: + return + if Time.get_ticks_msec() - _last_global_bark_ms < GLOBAL_BARK_GAP_MS: + return + var player := get_tree().get_first_node_in_group("player") as Node3D + if player == null or global_position.distance_to(player.global_position) > bark_radius: + return + if randf() > bark_chance: + return + _speak_from_pool() + + +## Spricht eine gewichtete Zufalls-Zeile aus dem passenden Pool. +func _speak_from_pool() -> void: + var pool_path := SCHERGEN_POOL_PATH if is_scherge else AMBIENT_POOL_PATH + var barks: Array = _pools.get(pool_path, []) + if barks.is_empty(): + return + _bubble.show_line(_pick_weighted(barks)) + _cooldown_left = bark_cooldown + _last_global_bark_ms = Time.get_ticks_msec() + + +## Anrempel-Ablauf: zum Ziel laufen, anrempeln + Drohzeile, zurück. +func _process_bump(delta: float) -> void: + if _bump_state == BumpState.APPROACHING: + if _bump_target == null or not is_instance_valid(_bump_target): + _bump_state = BumpState.RETURNING + return + var target := _bump_target.global_position + global_position = global_position.move_toward(target, walk_speed * delta) + if global_position.distance_to(target) < 1.0: + _execute_bump() + else: + global_position = global_position.move_toward(_home_position, walk_speed * delta) + if global_position.distance_to(_home_position) < 0.2: + _bump_state = BumpState.IDLE + + +## Der eigentliche Rempler: Ziel versetzen, Drohzeile, Reaktion des Ziels. +func _execute_bump() -> void: + var shove := (_bump_target.global_position - global_position) + shove.y = 0.0 + _bump_target.global_position += shove.normalized() * 0.5 + _speak_from_pool() + var target_bubble := _bump_target.get_node_or_null("SpeechBubble") + if target_bubble != null: + target_bubble.show_line("Hey—! Schon gut. Schon gut.") + _has_bumped = true + _bump_state = BumpState.RETURNING + + +## Lädt einen Bark-Pool einmalig in den statischen Cache. +func _load_pool(path: String) -> void: + if _pools.has(path): + return + var file := FileAccess.open(path, FileAccess.READ) + if file == null: + push_error("Bark-Pool fehlt: %s" % path) + _pools[path] = [] + return + var parsed: Variant = JSON.parse_string(file.get_as_text()) + if parsed is Dictionary and parsed.get("barks") is Array: + _pools[path] = parsed["barks"] + else: + push_error("Bark-Pool unlesbar: %s" % path) + _pools[path] = [] + + +## Zieht eine Zeile gewichtet aus dem Pool. +func _pick_weighted(barks: Array) -> String: + var total := 0.0 + for bark in barks: + total += float(bark.get("weight", 1)) + var roll := randf() * total + for bark in barks: + roll -= float(bark.get("weight", 1)) + if roll <= 0.0: + return str(bark.get("text", "")) + return str(barks[0].get("text", "")) diff --git a/scripts/gameplay/grey_cadet.gd.uid b/scripts/gameplay/grey_cadet.gd.uid new file mode 100644 index 0000000..5e1e028 --- /dev/null +++ b/scripts/gameplay/grey_cadet.gd.uid @@ -0,0 +1 @@ +uid://dsohkshqotcmd diff --git a/scripts/gameplay/grey_spawner.gd b/scripts/gameplay/grey_spawner.gd new file mode 100644 index 0000000..90fb028 --- /dev/null +++ b/scripts/gameplay/grey_spawner.gd @@ -0,0 +1,65 @@ +extends Node3D +## Spawner für „Die Grauen" (v1-Ausbau Phase 3). +## +## Verteilt beim Szenen-Start ambient_count graue Statisten zufällig in +## den spawn_extents um den Spawner. Ab Tag scherge_from_day (STORY §5: +## Tag 4) kommen zusätzlich scherge_count Schergen dazu (dunkler, mit +## Drohungs-Pool); einer davon startet nach kurzer Verzögerung das +## gezielte Wren-Anrempeln, sofern die Szene einen Wren-NPC hat +## (wren_path). Rein ambient — keine Interaktion, keine Kollision mit +## Dialog-Systemen. + +const GREY_CADET_SCENE := preload("res://scenes/npcs/grey_cadet.tscn") + +@export var ambient_count := 5 +@export var scherge_count := 2 +@export var scherge_from_day := 4 +@export var spawn_extents := Vector3(14, 0, 14) +@export var bump_delay := 6.0 +@export var wren_path: NodePath + +var _schergen: Array[Node3D] = [] + + +## Spawnt Statisten und (ab Tag scherge_from_day) die Schergen samt +## verzögertem Anrempel-Auftrag. +func _ready() -> void: + for i in ambient_count: + _spawn_cadet(false) + if TimeSystem.day_count < scherge_from_day: + return + for i in scherge_count: + _schergen.append(_spawn_cadet(true)) + if wren_path.is_empty(): + return + var wren := get_node_or_null(wren_path) + if wren == null or _schergen.is_empty(): + return + get_tree().create_timer(bump_delay).timeout.connect(_on_bump_timer.bind(wren)) + + +## Anzahl gespawnter Schergen (für Tests/Overlay). +func scherge_count_spawned() -> int: + return _schergen.size() + + +## Startet das Anrempeln beim ersten Schergen. +func _on_bump_timer(wren: Node3D) -> void: + if not _schergen.is_empty() and is_instance_valid(_schergen[0]): + _schergen[0].start_bump(wren) + + +## Spawnt einen Statisten an zufälliger Position in den Extents. +func _spawn_cadet(is_scherge: bool) -> Node3D: + var cadet := GREY_CADET_SCENE.instantiate() + cadet.is_scherge = is_scherge + add_child(cadet) + cadet.global_position = global_position + Vector3( + randf_range(-spawn_extents.x, spawn_extents.x), + 0.0, + randf_range(-spawn_extents.z, spawn_extents.z) + ) + cadet.rotation.y = randf_range(0.0, TAU) + if is_scherge: + cadet.apply_scherge_tint() + return cadet diff --git a/scripts/gameplay/grey_spawner.gd.uid b/scripts/gameplay/grey_spawner.gd.uid new file mode 100644 index 0000000..490720a --- /dev/null +++ b/scripts/gameplay/grey_spawner.gd.uid @@ -0,0 +1 @@ +uid://5hkrar4nuk36