diff --git a/docs/CHANGEREQUESTS.md b/docs/CHANGEREQUESTS.md index 78049da..785ad3e 100644 --- a/docs/CHANGEREQUESTS.md +++ b/docs/CHANGEREQUESTS.md @@ -11,44 +11,6 @@ > Findings des Autors beim Durchspielen von v1. **Priorität vor den Akt-2-CRs > weiter unten** — das ist Politur am fertigen v1-Umfang. -## 31. Gauntlet-Rad: Kollision, Fremdkörper-Platten, unklare Paddel, fehlende Streben -> Autor-Befund beim Testen, vier Symptome — alle im Code verifiziert -> (`spinning_wheel.gd`), keine Vermutung: -- **(a) Durchfallen bestätigt — Hauptursache.** Die 14 Hüllen-Segmente der - Trommel werden mit `build_box_mesh()` gebaut, das laut - `obstacle_base.gd` ausdrücklich **kein Kollisions-Shape** erzeugt - ("Deko/Silhouetten"). Die rotierende Außenhülle ist rein optisch — man kann - überall hindurchlaufen, nicht nur durch die vorgesehene Lücke. Widerspricht - der eigenen Spec des Rads („geschlossene, feste Hülle, genau EINE Lücke"). - **Fix:** Segmente brauchen echte Kollision (rotierend mit `_pivot`), dabei - muss die Lücke selbst weiterhin frei bleiben (kein Segment dort). -- **(b) Die zwei „Platten" am Ein-/Ausstieg.** Das sind die festen - Hüllen-Lippen (`build_box`-Aufrufe, Zeilen ~82–83) — sie sind **nicht** Kind - von `_pivot`, drehen sich also nicht mit der Trommel und wirken dadurch wie - lose stehende Fremdkörper statt integrierter Rand der Öffnung. **Fix:** - visuell so gestalten/positionieren, dass sie erkennbar zum feststehenden - Rahmen der Ein-/Ausstiegsöffnung gehören (z. B. als Türrahmen-Silhouette), - nicht wie zufällig platzierte Blöcke. -- **(c) Lila/blauer Balken — Zweck unklar.** Die zwei „Paddel" - (`Color(0.35,0.35,0.5)` / `Color(0.3,0.4,0.45)`, gedacht als - Dreh-Timing-Referenz laut Doku-Kommentar) lesen sich visuell nicht als - Mühlrad-Teile. **Fix:** entweder holzfarben/materialgleich zur Hülle - gestalten (klar als Speichen/Paddel erkennbar) oder Zweck anders - kommunizieren (z. B. Warnfarbe NUR wenn sie sich der Lücke nähern). -- **(d) Fehlende Streben rechts und links.** Auf den beiden seitlichen - Stirnflächen der Trommel (bei `z = ±drum_width/2`) fehlt jede - Speichen-/Rahmen-Geometrie — von der Seite betrachtet fehlt die typische - Mühlrad-Silhouette komplett. **Fix:** sichtbare Speichen-/Rahmenstruktur auf - beiden Stirnseiten ergänzen (rotiert mit `_pivot`, rein dekorativ reicht, - keine zusätzliche Kollision nötig). -- **Nicht anfassen:** Rotationslogik, Lücken-Timing-Fenster - (`wheel_entry_window`/`wheel_exit_window`), Mitnahme-Physik - (`wheel_carry_force`) — die Sonden aus CR 7 dazu bleiben gültig. -- **Akzeptanz:** Spieler kann nirgends außer durch die Lücke durch die - Trommel laufen/fallen; Ein-/Ausstiegsbereich wirkt wie ein integrierter Teil - des Rads statt lose Platten; die Paddel sind erkennbar Teil des Mühlrads; - von der Seite betrachtet zeigt das Rad eine erkennbare Speichen-Silhouette. - ## 25. Absturz beim Türen-/Zonenwechsel — IN BEOBACHTUNG (Härtung + Forensik drin, 2026-07-21) > Autor: „Das Game crasht öfters, wenn man durch Türen geht" — Symptombild laut > Rückfrage: **Fenster minimiert sich, Standbild**, immer andere Türen. diff --git a/docs/CHANGEREQUESTS_DONE.md b/docs/CHANGEREQUESTS_DONE.md index bfd3c2c..993281f 100644 --- a/docs/CHANGEREQUESTS_DONE.md +++ b/docs/CHANGEREQUESTS_DONE.md @@ -3,6 +3,62 @@ > Abgearbeitete Change Requests aus CHANGEREQUESTS.md, mit Datum und > Anmerkung, was geändert wurde. +## 2026-07-22 — CR 31: Gauntlet-Rad — feste Hülle, Türrahmen, Speichen + +**Request:** CHANGEREQUESTS §31 — vier im Code verifizierte Symptome am +Mühlrad: durchfallbare Hülle, lose wirkende Ein-/Ausstiegs-Platten, +bläulich-violette Paddel, fehlende Speichen. Rotationslogik, +Timing-Fenster und Mitnahme-Physik ausdrücklich nicht anfassen. + +**(a) Hauptfix — die Hülle blockt jetzt wirklich.** Die 14 Segmente +wurden mit `build_box_mesh()` gebaut, das laut `obstacle_base.gd` +bewusst **kein** Kollisions-Shape erzeugt („Deko/Silhouetten") — die +Außenhülle war reine Optik, man lief überall hindurch. Jedes Segment ist +jetzt ein **AnimatableBody3D** mit eigenem BoxShape, Kind von `_pivot`, +dreht also mit. `sync_to_physics` bleibt **aus**: Die Segmente sollen +blocken, das Mitnehmen macht weiterhin allein `wheel_carry_force` — +sonst hätte die Hülle den Läufer zusätzlich geschoben und die +CR-7-Balance verfälscht. Die Lücke bleibt frei, weil die Segmentschleife +sie ohnehin aussparte. + +**(b) Öffnungsrahmen.** Die beiden festen Lippen bleiben, wo sie sind +(sie sind die Kante, über die man springt), bekommen aber einen +feststehenden Rahmen: zwei Pfosten seitlich der Durchgangsbreite plus +Sturz darüber, rein dekorativ und **nicht** Kind von `_pivot`. Im +Rendering liest sich die Lippe jetzt als Schwelle einer Toröffnung statt +als loser Block. + +**(c) Paddel** tragen die Holztöne der Hülle statt +`Color(0.35,0.35,0.5)` / `Color(0.3,0.4,0.45)`. + +**(d) Speichen** auf beiden Stirnseiten: je drei Balken durch die Mitte +(= sechs Speichen) plus Nabe, Kind von `_pivot`, ohne Kollision. Von der +Seite zeigt das Rad jetzt eine erkennbare Mühlrad-Silhouette. + +**Zwei Fehlschläge, die meine Prüfer waren, nicht der Code:** +`AnimatableBody3D` **erbt** von `StaticBody3D` — mein „Rahmen hängt +nicht am Pivot"-Test schlug deshalb auf die eigenen Hüllensegmente an. +Und ein Testkörper, der radial gegen die Hülle gedrückt wird, **rutscht** +an der tangentialen Fläche entlang bis in die Lücke und kommt so hinein +— korrektes Verhalten, aber als „Loch" fehlgedeutet. Der Nachweis läuft +deshalb über **Strahlen**, die nicht rutschen und wirklich die Geometrie +messen. Ebenso: Am Trommelboden liegt der innere Stützboden im Strahl, +die Lücken-Wanderung wird darum oben geprüft. + +**Verifikation:** Zwei Sonden. `dev_cr31_probe` 20/20 — 14 feste +Segmente mit Shape am Pivot, `sync_to_physics` aus, kein Segment in der +Lücke, Hülle rundum belegt, Kollision wandert mit der Drehung (0,88 m in +0,5 s); Rahmen an beiden Öffnungen und am Gerüst statt am Pivot, ohne +den Durchgang zu versperren; kein bläuliches Teil mehr; Speichen auf +beiden Seiten ohne Zusatzkollision; **Rotationsformel, Ein-/ +Ausstiegsfenster, Mitnahme-Formel und Sturz-Bedingung zeichengleich +unverändert** (Quelltext-Prüfung), Wände öffnen und schließen weiter im +Fenster. `dev_cr31_solid` 4/4 — **149 Strahlen** rundum blocken +ausnahmslos, alle 9 Strahlen in der Lücke gehen durch, nach der Drehung +ist die alte Lückenstelle zu und die Lücke mitgewandert. Boot-Check über +zehn Szenen (inkl. aller fünf Terrassen) fehlerfrei. Zusätzlich drei +gerenderte Ansichten geprüft. Sonden vor dem Commit gelöscht. + ## 2026-07-22 — CR 30: Absagetexte an Türen sprechen jetzt in Charakter **Request:** CHANGEREQUESTS §30 — statt der einen generischen Meldung diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 137cbb5..6afa977 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -152,7 +152,7 @@ Greifen erst nach Dreschen + erstem Flug; brauchen die CR-6-Basis. | 28 | Journal-Kalender: Stundenplan statt Spoiler | Politur | **erledigt (2026-07-22)** — zwei Wochen-Seiten, echte Wochentage, Fach je Slot; kein Beat/Titel mehr auf der Seite | | 29 | Quest-Tracker-Box im HUD | Politur | **erledigt (2026-07-22)** — Box oben links im Player, Ziel aus Fahrplan/Szene abgeleitet, reine Anzeige | | 30 | Rollenspiel-Absagetexte an Türen | Politur | **erledigt (2026-07-22)** — sieben eigene Texte in `raeume.json`, Fallback für unbekannte room_ids, `_is_open()` unverändert | -| 31 | Gauntlet-Rad: Kollision + Optik | Politur | offen — Hauptursache (keine Hüllen-Kollision) verifiziert | +| 31 | Gauntlet-Rad: Kollision + Optik | Politur | **erledigt (2026-07-22)** — Hülle blockt (149 Strahlen), Türrahmen, Holzfarben, Speichen; Rotation/Fenster/Mitnahme unangetastet | | 14 | Aula-Bau + Tür-Fix | 1 | erledigt (2026-07-19) | | 15 | Hub-Layout an Karte | 1 | erledigt (2026-07-19) | | 16 | Permadeath raus → Save/Camp | 1 (Camp: Akt 2) | erledigt (2026-07-19); Camp-Rest: Akt 2 | diff --git a/scripts/gameplay/obstacles/spinning_wheel.gd b/scripts/gameplay/obstacles/spinning_wheel.gd index 021161b..906b8e0 100644 --- a/scripts/gameplay/obstacles/spinning_wheel.gd +++ b/scripts/gameplay/obstacles/spinning_wheel.gd @@ -18,6 +18,19 @@ extends GauntletObstacle ## Sicht des zulaufenden Spielers (die Trommel-Unterseite läuft mit in ## Laufrichtung und trägt zum Ausstieg). Zwei Paddel drehen als ## sichtbare Timing-Referenz mit. +## +## **Hülle ist fest (CR 31):** Die Segmente sind AnimatableBody3D — sie +## drehen mit _pivot und blocken echt. Vorher waren sie reine Meshes +## (build_box_mesh erzeugt laut obstacle_base bewusst keine Kollision), +## man konnte also überall durchlaufen statt nur durch die Lücke. Die +## Lücke selbst bleibt frei, weil die Segmentschleife sie ohnehin +## aussparte. sync_to_physics bleibt aus: Die Segmente sollen blocken, +## das Mitnehmen macht weiterhin allein wheel_carry_force. +## +## Rein dekorativ dazu: ein feststehender Rahmen um beide Öffnungen +## (damit die Lippen als Teil der Öffnung lesbar sind statt als lose +## Blöcke) und Speichen auf beiden Stirnseiten, die mit _pivot drehen — +## von der Seite sieht man jetzt ein Mühlrad. signal wheel_entered signal wheel_exited @@ -35,6 +48,13 @@ const ENTRY_ANGLE := PI const EXIT_ANGLE := 0.0 const BOTTOM_ANGLE := -PI / 2.0 const LIP_HEIGHT := 0.9 +const SEGMENT_COUNT := 14 +const SEGMENT_THICKNESS := 0.25 +const WOOD_SHELL := Color(0.5, 0.4, 0.3) +const WOOD_FRAME := Color(0.42, 0.33, 0.24) +const WOOD_SPOKE := Color(0.46, 0.36, 0.27) +const SPOKE_BARS := 3 +const FRAME_POST_WIDTH := 0.22 var _pivot: Node3D var _entry_wall_shape: CollisionShape3D @@ -55,18 +75,16 @@ func _ready() -> void: _pivot = Node3D.new() _pivot.position = center add_child(_pivot) - var segment_count := 14 var arc := TAU - wheel_gap_arc - var segment_length := arc / float(segment_count) * radius - for i in segment_count: - var angle := ENTRY_ANGLE + wheel_gap_arc / 2.0 + arc * (float(i) + 0.5) / float(segment_count) - var segment := build_box_mesh(Vector3(segment_length * 1.05, 0.25, drum_width), Vector3(cos(angle) * radius, sin(angle) * radius, 0), Color(0.5, 0.4, 0.3)) - segment.rotation.z = angle + PI / 2.0 - _pivot.add_child(segment) - var paddle1 := build_box_mesh(Vector3(0.2, radius * 0.8, drum_width * 0.9), Vector3(cos(ENTRY_ANGLE + PI * 0.5) * radius * 0.55, sin(ENTRY_ANGLE + PI * 0.5) * radius * 0.55, 0), Color(0.35, 0.35, 0.5)) + var segment_length := arc / float(SEGMENT_COUNT) * radius + for i in SEGMENT_COUNT: + var angle := ENTRY_ANGLE + wheel_gap_arc / 2.0 + arc * (float(i) + 0.5) / float(SEGMENT_COUNT) + _build_shell_segment(angle, segment_length, radius) + _build_spokes(radius) + var paddle1 := build_box_mesh(Vector3(0.2, radius * 0.8, drum_width * 0.9), Vector3(cos(ENTRY_ANGLE + PI * 0.5) * radius * 0.55, sin(ENTRY_ANGLE + PI * 0.5) * radius * 0.55, 0), WOOD_SPOKE) paddle1.rotation.z = ENTRY_ANGLE + PI * 0.5 + PI / 2.0 _pivot.add_child(paddle1) - var paddle2 := build_box_mesh(Vector3(0.2, radius * 0.8, drum_width * 0.9), Vector3(cos(ENTRY_ANGLE + PI * 1.4) * radius * 0.55, sin(ENTRY_ANGLE + PI * 1.4) * radius * 0.55, 0), Color(0.3, 0.4, 0.45)) + var paddle2 := build_box_mesh(Vector3(0.2, radius * 0.8, drum_width * 0.9), Vector3(cos(ENTRY_ANGLE + PI * 1.4) * radius * 0.55, sin(ENTRY_ANGLE + PI * 1.4) * radius * 0.55, 0), WOOD_SHELL) paddle2.rotation.z = ENTRY_ANGLE + PI * 1.4 + PI / 2.0 _pivot.add_child(paddle2) var floor_body := StaticBody3D.new() @@ -79,12 +97,68 @@ func _ready() -> void: add_child(floor_body) _entry_wall_shape = _build_wall(-radius, center.y) _exit_wall_shape = _build_wall(radius, center.y) - build_box(self, Vector3(0.3, LIP_HEIGHT, drum_width), Vector3(-radius, LIP_HEIGHT / 2.0, 0), Color(0.45, 0.36, 0.28)) - build_box(self, Vector3(0.3, LIP_HEIGHT, drum_width), Vector3(radius, LIP_HEIGHT / 2.0, 0), Color(0.45, 0.36, 0.28)) + build_box(self, Vector3(0.3, LIP_HEIGHT, drum_width), Vector3(-radius, LIP_HEIGHT / 2.0, 0), WOOD_FRAME) + build_box(self, Vector3(0.3, LIP_HEIGHT, drum_width), Vector3(radius, LIP_HEIGHT / 2.0, 0), WOOD_FRAME) + _build_opening_frame(-radius) + _build_opening_frame(radius) var exit_zone := build_area(self, Vector3(1.2, 2.6, drum_width + 0.4), Vector3(radius + 0.9, 1.2, 0)) exit_zone.body_entered.connect(_on_exit_zone) +## Ein Hüllen-Segment mit echter Kollision, das mit _pivot dreht +## (CR 31a). AnimatableBody3D statt StaticBody3D, weil der Körper per +## Code bewegt wird; sync_to_physics bleibt aus, damit er nur blockt und +## die Mitnahme allein bei wheel_carry_force liegt. +func _build_shell_segment(angle: float, segment_length: float, radius: float) -> void: + var body := AnimatableBody3D.new() + body.sync_to_physics = false + body.position = Vector3(cos(angle) * radius, sin(angle) * radius, 0) + body.rotation.z = angle + PI / 2.0 + var size := Vector3(segment_length * 1.05, SEGMENT_THICKNESS, drum_width) + var shape := CollisionShape3D.new() + var box := BoxShape3D.new() + box.size = size + shape.shape = box + body.add_child(shape) + body.add_child(build_box_mesh(size, Vector3.ZERO, WOOD_SHELL)) + _pivot.add_child(body) + + +## Speichen und Nabe auf beiden Stirnseiten der Trommel (CR 31d) — rein +## dekorativ, dreht mit _pivot. Jeder Balken läuft durch die Mitte und +## bildet damit zwei gegenüberliegende Speichen. +func _build_spokes(radius: float) -> void: + for side in [-1.0, 1.0]: + var z: float = side * (drum_width / 2.0 + 0.04) + for i in SPOKE_BARS: + var bar := build_box_mesh( + Vector3(0.16, radius * 2.0 - SEGMENT_THICKNESS, 0.08), + Vector3(0, 0, z), WOOD_SPOKE) + bar.rotation.z = PI * float(i) / float(SPOKE_BARS) + _pivot.add_child(bar) + var hub := build_cylinder_mesh(radius * 0.16, 0.14, Vector3(0, 0, z), WOOD_FRAME) + hub.rotation.x = PI / 2.0 + _pivot.add_child(hub) + + +## Feststehender Rahmen um eine Ein-/Ausstiegsöffnung (CR 31b): zwei +## Pfosten seitlich der Durchgangsbreite und ein Sturz darüber. Rein +## dekorativ und NICHT Kind von _pivot — er gehört zum Gerüst, nicht zur +## Trommel, und macht die Lippe als Teil der Öffnung lesbar. +func _build_opening_frame(local_x: float) -> void: + var height := wheel_diameter + for side in [-1.0, 1.0]: + var post := build_box_mesh( + Vector3(FRAME_POST_WIDTH, height, FRAME_POST_WIDTH), + Vector3(local_x, height / 2.0, float(side) * (drum_width / 2.0 + FRAME_POST_WIDTH / 2.0)), + WOOD_FRAME) + add_child(post) + var lintel := build_box_mesh( + Vector3(FRAME_POST_WIDTH, FRAME_POST_WIDTH, drum_width + FRAME_POST_WIDTH * 2.0), + Vector3(local_x, height + FRAME_POST_WIDTH / 2.0, 0), WOOD_FRAME) + add_child(lintel) + + ## Baut eine unsichtbare Sperrwand über der Lippe einer Trommelseite; ## ihre Shape wird freigegeben, solange die Lücke dort steht. func _build_wall(local_x: float, center_y: float) -> CollisionShape3D: