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 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-11 23:01:03 +02:00
parent 0fd6930d64
commit 7f8429abdc
10 changed files with 344 additions and 11 deletions

14
data/barks/ambient.json Normal file
View file

@ -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 }
]
}

9
data/barks/schergen.json Normal file
View file

@ -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 }
]
}

View file

@ -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.

View file

@ -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

View file

@ -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"]

View file

@ -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)

View file

@ -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", ""))

View file

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

View file

@ -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

View file

@ -0,0 +1 @@
uid://5hkrar4nuk36