diff --git a/docs/CHANGEREQUESTS.md b/docs/CHANGEREQUESTS.md index 90b6fdc..ff17da2 100644 --- a/docs/CHANGEREQUESTS.md +++ b/docs/CHANGEREQUESTS.md @@ -97,25 +97,6 @@ - **Wichtig:** Reiner Schreibpass — **keine** Story-Fakten, Flags, Effekte oder Verzweigungen ändern (Ton ≠ Ausgang, STORY §6). -## 20. Viadukt-Respawn wirft in den Schlafsaal (CR-16-Regression) -> **Bug, Ursache gefunden.** -- **Symptom:** Fällt man vom Viadukt, spawnt man im **Schlafsaal** statt am Viadukt. -- **Ursache:** `viaduct.gd:114` ruft `SaveSystem.reload_last_save()` — man landet - am letzten Speicherpunkt. Die Checkpoint-Logik existiert noch - (`_checkpoint_position`, Zeilen 49/105), wird aber **nie zum Respawn benutzt**. - Eingeschleppt mit CR 16. Der **Gauntlet macht es korrekt** - (`gauntlet.gd:384` respawnt am Checkpoint) — zwei gleichartige Set-Pieces, zwei - Verhalten. -- **Einheitliche Todes-Regel (entschieden 2026-07-21):** - - **Set-Pieces mit Checkpoints — Viadukt und Gauntlet — respawnen am letzten - Checkpoint** innerhalb des Laufs. - - `reload_last_save()` bleibt **nur** für die Story-Tode: Tag-9-Hinterhalt - (`cassian_ambush.gd`) und Dreschen-Prüfung (`hatching_grounds.gd`). -- **Akzeptanz:** Sturz am Viadukt setzt den Spieler am zuletzt erreichten - Viadukt-Checkpoint ab (bzw. am Anfang des Laufs, wenn noch keiner erreicht wurde); - kein Szenenwechsel, kein Laden; Gauntlet-Verhalten unverändert; SPEC §6 - („Speichersystem") um die Checkpoint-Ausnahme ergänzen. - ## 21. „Blätter jagen": echte Hatz statt driftendes Pickup > Delta gegen die CR-12-Umsetzung. Vorbild: die Sea-Shanty-Seiten aus AC4 > Black Flag. @@ -230,21 +211,25 @@ --- ## Phasen-Plan (Reihenfolge für den Entwickler-Claude) -> _Status (2026-07-20, Claude): **Wellen 1–3 sind komplett abgearbeitet.** -> Welle 1 (CR 16 Speichersystem, CR 6 Zweitsignet latent, CR 5 Staffel-Setup, -> CR 14+15 Aula + Hub-Layout), Welle 2 (CR 8a–8e — Kampfsystem komplett) und -> Welle 3 (CR 11 Gefechtskunde-Karte, CR 12 Blätter jagen, CR 13 Minispiele) -> sind erledigt, siehe CHANGEREQUESTS_DONE. Damit sind auch die Phasen 7–11 -> und CR 1–7 durch. **Der v1-Umfang ist damit inhaltlich beisammen.**_ +> _Status (2026-07-21, Claude): **Wellen 0–3 sind komplett abgearbeitet** +> (Phasen 0–11, CR 1–16, CR 8a–8e Kampfsystem, CR 11–13 Flavor) — **der +> v1-Umfang ist inhaltlich beisammen.** Zusätzlich erledigt: **CR 23** +> (Asset-Pipeline mit fünf Quaternius-CC0-Packs steht und ist verifiziert)._ > -> _Offen — nur noch **Welle 4 (Akt 2, jenseits v1)** und ein Stretch:_ -> - _CR 9 (Bindungs-Achse), CR 10 (Drachenpflege), CR 8-magie (Magie im Kampf), -> CR-16-Rest (Camp im Feld) — alle setzen die Bindung an Smàladh voraus und -> greifen erst **nach** dem Dreschen/ersten Flug._ -> - _CR 13-Rest: eigenes Kartenspiel (Stretch, kein v1-Ziel)._ -> -> _Nächster inhaltlicher Schritt ist NICHT Code, sondern Story: **Akt 2 ist in -> STORY.md §9 ausdrücklich „noch auszuarbeiten"** — ohne ihn hängen CR 9/10/ -> 8-magie in der Luft._ +> _Offen, in Prioritätsreihenfolge:_ +> - **Politur-Welle CR 17–22** (Findings aus dem Akt-1-Testdurchlauf) — voll +> spezifiziert, bereit zur Umsetzung, noch nicht dispatcht. Reihenfolge: +> CR 20 (Bugfix, klein) → CR 18 (Viertes Geschwader) → CR 17 (Poker) → +> CR 21 (Blätter) → CR 19+22 (Schreibpass, ein Durchgang). +> - **CR 24** (Primitiven-Austausch, Folge-Schritt aus CR 23) — zwei offene +> Autoren-Entscheidungen zuerst klären (Textur-Downscale 4K→1K/2K?, +> Blender-Trimm-Schritt für den Basis-Körper bestätigen), dann Szene für +> Szene umsetzen. +> - **CR 13-Rest** (eigenes Kartenspiel) — Stretch, kein v1-Ziel, keine Eile. +> - **Welle 4 (Akt 2, jenseits v1):** CR 9, CR 10, CR 8-magie, CR-16-Rest +> (Camp) — alle setzen die Bindung an Smàladh voraus. **Nächster +> inhaltlicher Schritt davor ist KEIN Code, sondern Story:** Akt 2 ist in +> STORY.md §9 ausdrücklich „noch auszuarbeiten" — ohne ihn hängen diese +> drei CRs in der Luft. > > _Vollständige, gewichtete Reihenfolge in Wellen: **ROADMAP.md**._ diff --git a/docs/CHANGEREQUESTS_DONE.md b/docs/CHANGEREQUESTS_DONE.md index 4a61239..5099029 100644 --- a/docs/CHANGEREQUESTS_DONE.md +++ b/docs/CHANGEREQUESTS_DONE.md @@ -3,6 +3,49 @@ > Abgearbeitete Change Requests aus CHANGEREQUESTS.md, mit Datum und > Anmerkung, was geändert wurde. +## 2026-07-21 — CR 20: Viadukt-Respawn am Checkpoint (CR-16-Regression) + +**Request:** CHANGEREQUESTS §20 — Sturz am Viadukt warf in den Schlafsaal, +weil `viaduct.gd` `SaveSystem.reload_last_save()` rief, obwohl die +Checkpoint-Logik längst existierte. Einheitliche Todes-Regel: Viadukt und +Gauntlet respawnen am Checkpoint, `reload_last_save()` bleibt den +Story-Toden vorbehalten. + +**Umsetzung:** `_on_kill_zone_entered()` setzt Tyrveil jetzt über +`_respawn_at_checkpoint()` am zuletzt erreichten Checkpoint ab — ohne +Szenenwechsel, ohne Laden; wurde noch keiner berührt, beginnt der Lauf am +Steganfang. Der neue `Player.reset_motion()` löscht dabei Geschwindigkeit +und Fremdschub, damit der Sturzimpuls nicht mit auf den Steg +zurückkommt. `BalanceQTE.cancel()` bricht ein noch laufendes QTE über +einen Generations-Zähler (`_run_id`) ergebnislos ab — sonst hätte die +wartende Coroutine den frisch abgesetzten Spieler sofort wieder vom Steg +gestoßen. Gauntlet unverändert. SPEC §6 um die Checkpoint-Ausnahme +ergänzt. + +**Dabei aufgefallen und nach Autoren-Entscheidung mitbehoben — Wind +wirkte als Beschleunigung:** `player.gd` rechnete `velocity.x += +external_push.x` pro Physik-Frame, während die Abklingrechnung im +Stillstand `velocity.x` samt Windanteil des Vorframes erneut einlas. Die +Seitwärtsgeschwindigkeit lief dadurch ungebremst davon — gemessen 0 auf +−21 m/s in einer Sekunde bei konstantem Schub von −0,7. Der Fehler war +**Altbestand**, nur unsichtbar, weil der Tod bisher die Szene neu lud; +mit dem Checkpoint-Respawn hätte er den Spieler sofort wieder +heruntergeblasen. `_process_normal()` zieht jetzt den zuletzt +angewandten Schub zu Frame-Beginn wieder ab (`_applied_push`). Der Wind +ist damit die Zusatz-Geschwindigkeit, die sein Doc-Block immer +beschrieben hat. Gemessen nach dem Fix: konstant 0,70 m/s seitlich, +1,07 m Versatz in 1,5 s. **Das Viadukt ist dadurch spürbar +gutmütiger** — bewusste Balancing-Entscheidung des Autors. + +**Verifikation:** Sonde `dev_cr20_probe` 19/19 — kein +`reload_last_save()` mehr im Viadukt, Story-Tode behalten es; +Respawn am Steganfang ohne erreichten Checkpoint und am erreichten +Checkpoint danach; kein Szenenwechsel; Restgeschwindigkeit und Windkraft +gelöscht; laufendes QTE wird abgebrochen, gibt die Steuerung frei und +stößt nicht nach; Seitengeschwindigkeit läuft nicht mehr davon und bleibt +in der Größenordnung der Windkraft. Boot-Check über acht Szenen +fehlerfrei. Sonde vor dem Commit gelöscht. + ## 2026-07-21 — CR 23: Asset-Import-Grundausstattung (Quaternius, CC0) **Request:** CHANGEREQUESTS §23 — fünf CC0-Quaternius-Packs aus diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 7d422a6..ceb0fd1 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -8,7 +8,8 @@ > Stand: **2026-07-21**. Erledigt: Phasen 0–11, CR 1–8 (8a–8e), CR 11–16, > CR 23 (Asset-Pipeline steht und ist verifiziert) — **Wellen 0–3 komplett**, > v1 steht inhaltlich. Offen: die **Politur-Welle -> CR 17–22** (Findings aus dem Akt-1-Testdurchlauf, Priorität), der +> CR 17–19, 21, 22** (Findings aus dem Akt-1-Testdurchlauf, Priorität; CR 20 +> ist erledigt), der > Primitiven-Austausch **CR 24** (Folge-Schritt aus CR 23), danach Welle 4 > (Akt 2: CR 9/10/8-magie/CR-16-Camp) und das eigene Kartenspiel (Stretch). @@ -22,7 +23,7 @@ auf fertigen Systemen, zuletzt die **Akt-2-Features** (jenseits v1). Der ursprüngliche Bau-Pfad (kleine Fixes → CR-8-Bau → Flavor) ist **vollständig durchlaufen**; v1 steht inhaltlich. -**Jetzt: Politur-Welle** (CR 17–22 aus dem Akt-1-Testdurchlauf) — v1 rundschleifen, +**Jetzt: Politur-Welle** (CR 17–22 aus dem Akt-1-Testdurchlauf; CR 20 erledigt) — v1 rundschleifen, bevor Akt 2 aufgemacht wird. **Danach ist der Engpass kein Code, sondern Story:** **Akt 2 ist in STORY.md §9 @@ -90,8 +91,6 @@ Setzen auf bereits erledigte Systeme auf (CR 8 nicht nötig). **Priorität vor Welle 4.** Findings des Autors am fertigen v1-Umfang. Gut parallelisierbar; zwei davon sind reine Schreibarbeit. -- **CR 20 — Viadukt-Respawn-Fix** (Bug, CR-16-Regression). Klein und isoliert, - **zuerst** — Sturz wirft aktuell in den Schlafsaal statt an den Checkpoint. - **CR 18 — Viertes Geschwader existiert** (Ridoc, Sawyer, Liam, Dain sprechen). Content; Ridoc zuerst, weil CR 17 ihn als Dealer braucht. - **CR 17 — Poker mit echten Karten + Figuren am Tisch.** UI-Overlay; Karten-PNGs @@ -130,7 +129,7 @@ Greifen erst nach Dreschen + erstem Flug; brauchen die CR-6-Basis. | 17 | Poker: echte Karten + Figuren am Tisch | Politur | offen | | 18 | Viertes Geschwader (Ridoc/Sawyer/Liam/Dain) | Politur | offen | | 19 | Stimmen-Schreibpass (Dialoge) | Politur | offen | -| 20 | Viadukt-Respawn-Fix (Bug) | Politur | offen | +| 20 | Viadukt-Respawn-Fix (Bug) | Politur | **erledigt (2026-07-21)** — Respawn am Checkpoint; dabei Wind-Beschleunigungs-Bug in `player.gd` mitbehoben | | 21 | Blätter-Jagd (Black-Flag-Gefühl) | Politur | offen | | 22 | Journal/Lexicon-Texte | Politur | offen | | 23 | Asset-Import-Grundausstattung (Quaternius) | Politur | **erledigt (2026-07-21)** — 296 Modelle sortiert unter `assets/models/`, Rig-Kompatibilität in `scenes/test/asset_pipeline_test.tscn` verifiziert | diff --git a/docs/SPEC.md b/docs/SPEC.md index 02404b5..4cbb17d 100644 --- a/docs/SPEC.md +++ b/docs/SPEC.md @@ -199,6 +199,12 @@ Kaoris Klassenzimmer statt der architektonischen Buch-Rotunda): **ORTE.md**. Gespeichert wird über das **ESC-Menü** und beim **Schlafen** (Tagesende); ein **Camp** zum Speichern gibt es nur **außerhalb Basgiaths** (Akt 2, nicht in v1). Sterben = zurück zum letzten Spielstand (Todesgefahr-Dramatik bleibt). + - **Checkpoint-Ausnahme (CR 20, entschieden 2026-07-21):** Die beiden + Set-Pieces mit eigenen Checkpoints — **Viadukt und Gauntlet** — respawnen + innerhalb des Laufs am **zuletzt erreichten Checkpoint**: kein Szenenwechsel, + kein Laden, der Lauf kostet Zeit statt Fortschritt. Der Griff zum Spielstand + (`SaveSystem.reload_last_save()`) bleibt den **Story-Toden** vorbehalten: + Tag-9-Hinterhalt und Dreschen-Prüfung. - **Save/Load**. - **Codex/Journal**: Drachen, Charaktere, Lore (füllt sich beim Entdecken). - **Mature-Content**: 18+-Gate beim 1. Start + Content-Warnung + Options-Toggle diff --git a/scripts/gameplay/balance_qte.gd b/scripts/gameplay/balance_qte.gd index f16459f..0e0d2dc 100644 --- a/scripts/gameplay/balance_qte.gd +++ b/scripts/gameplay/balance_qte.gd @@ -32,6 +32,7 @@ var _weather: Node var _is_active := false var _last_input_dir := 0 var _label: Label +var _run_id := 0 ## Verknüpft Spieler, Wetter-Controller und Steg-Breite und baut den @@ -53,6 +54,20 @@ func is_active() -> bool: return _is_active +## Bricht ein laufendes QTE ergebnislos ab: Prompt aus, Steuerung frei, +## und die noch wartende Coroutine läuft ins Leere. Nötig beim Respawn +## (CR 20) — sonst stößt ein überlebendes QTE den gerade am Checkpoint +## abgesetzten Spieler sofort wieder vom Steg. +func cancel() -> void: + if not _is_active: + return + _run_id += 1 + _is_active = false + _hide_prompt() + if _player != null: + _player.set_control_locked(false) + + ## Zeichnet während eines aktiven QTE die zuletzt gedrückte Seitenrichtung ## auf; der Player ist dann gesperrt, sodass die Eingabe hier ankommt. func _unhandled_input(event: InputEvent) -> void: @@ -82,6 +97,8 @@ func _on_gust_started(direction: int, strength_mult: float) -> void: ## Spielt das QTE als Coroutine ab: Steuerung sperren, je Tap die ## Gegensteuer-Taste anzeigen und im Zeitfenster abfragen, dann auflösen. func _run_qte(slip_dir: int) -> void: + _run_id += 1 + var own_id := _run_id _is_active = true slip_triggered.emit(slip_dir) _player.set_control_locked(true) @@ -94,6 +111,8 @@ func _run_qte(slip_dir: int) -> void: _last_input_dir = 0 _show_prompt(counter) var is_ok := await _await_tap(counter, window) + if own_id != _run_id: + return if not is_ok: _fail(slip_dir) return diff --git a/scripts/gameplay/player.gd b/scripts/gameplay/player.gd index 478bc89..45aa329 100644 --- a/scripts/gameplay/player.gd +++ b/scripts/gameplay/player.gd @@ -56,6 +56,7 @@ var _state := MovementState.NORMAL var _is_dialogue_locked := false var _is_panning := false var external_push := Vector3.ZERO +var _applied_push := Vector3.ZERO var _target_zoom := 9.0 var _gravity: float = ProjectSettings.get_setting("physics/3d/default_gravity") var _slide_direction := Vector3.ZERO @@ -144,6 +145,15 @@ func set_control_locked(is_locked: bool) -> void: ## Gibt zurück, ob die Steuerung gerade gesperrt ist (Dialog, Kamera- ## Schwenk, QTE). Das Wind-/Balance-System des Viadukts pausiert dann. +## Löscht die gesamte Bewegung samt anliegendem und zuletzt angewandtem +## Fremdschub. Für Respawns (CR 20): danach steht Tyrveil wirklich still, +## statt mit dem Restimpuls des Sturzes weiterzurutschen. +func reset_motion() -> void: + velocity = Vector3.ZERO + external_push = Vector3.ZERO + _applied_push = Vector3.ZERO + + func is_control_locked() -> bool: return _is_dialogue_locked @@ -204,7 +214,17 @@ func get_movement_state_name() -> String: ## Normale Bewegung: Schwerkraft, kamerarelatives Laufen mit Sprint und ## Sprung, danach Slide-Einstieg und Kletter-Kantenerkennung prüfen. +## +## external_push (Seitenwind am Viadukt) ist eine Zusatz-GESCHWINDIGKEIT, +## keine Beschleunigung: Der Schub des Vorframes wird zu Beginn wieder +## abgezogen, bevor die Bewegung neu gerechnet wird. Ohne das liest die +## Abklingrechnung im Stillstand ihren eigenen Windanteil erneut ein und +## der Spieler wird über die Frames hinweg immer schneller zur Seite +## gerissen (CR 20 — der Fehler fiel erst auf, als der Respawn am +## Checkpoint den Spieler im Wind stehen ließ, statt die Szene zu laden). func _process_normal(delta: float) -> void: + velocity.x -= _applied_push.x + velocity.z -= _applied_push.z if not is_on_floor(): velocity.y -= _gravity * delta elif Input.is_action_just_pressed("jump"): @@ -223,6 +243,7 @@ func _process_normal(delta: float) -> void: velocity.z = move_toward(velocity.z, 0.0, STOP_SPEED * delta) velocity.x += external_push.x velocity.z += external_push.z + _applied_push = external_push move_and_slide() if is_on_floor() and Input.is_action_just_pressed("slide"): _try_start_slide() diff --git a/scripts/gameplay/viaduct.gd b/scripts/gameplay/viaduct.gd index a81c224..a8099c9 100644 --- a/scripts/gameplay/viaduct.gd +++ b/scripts/gameplay/viaduct.gd @@ -12,9 +12,14 @@ extends Node3D ## Gegensteuern). Beim Betreten läuft der cineastische Kamera-Schwenk ## (SPEC Abschnitt 2). Wren läuft voraus und strauchelt beim Einholen ## (nicht abbrechbarer Dialog, Story-Flag viaduct_wren_rescue). Ein Sturz -## in die KillZone ist der Tod und führt auf den letzten Spielstand -## zurück (CR 16; im Prolog ohne Spielstand startet der Lauf neu). Optionaler Vorlauf (250-Stufen-Turmaufstieg vor dem -## Steg) ist bewusst NICHT Teil dieses CR — bei Bedarf eigener CR. +## in die KillZone ist der Tod und setzt Tyrveil am zuletzt erreichten +## Checkpoint wieder ab — ohne Szenenwechsel, ohne Laden (CR 20). Damit +## verhalten sich die beiden Set-Pieces mit Checkpoints, Viadukt und +## Gauntlet, gleich; der Griff zum Spielstand +## (SaveSystem.reload_last_save) bleibt den Story-Toden vorbehalten: +## Tag-9-Hinterhalt und Dreschen-Prüfung. Optionaler Vorlauf +## (250-Stufen-Turmaufstieg vor dem Steg) ist bewusst NICHT Teil dieses +## CR — bei Bedarf eigener CR. const WREN_DIALOGUE_PATH := "res://data/dialogue/viaduct_wren.json" const WREN_WALK_SPEED := 1.2 @@ -105,10 +110,27 @@ func _on_checkpoint_entered(body: Node3D, checkpoint: Area3D) -> void: _checkpoint_position = Vector3(checkpoint.global_position.x, 0.1, checkpoint.global_position.z) -## Sturz in die Nebelschlucht ist der Tod: zurück auf den letzten -## Spielstand (CR 16 — im Prolog ohne Spielstand beginnt der Lauf neu). +## Sturz in die Nebelschlucht ist der Tod: Respawn am zuletzt erreichten +## Checkpoint, ohne Szenenwechsel und ohne Laden (CR 20, einheitliche +## Todes-Regel). Wurde noch kein Checkpoint berührt, beginnt der Lauf am +## Steganfang. Wind, Wetter und das Balance-QTE werden zurückgesetzt, +## damit der Spieler nicht mitten in einer Böe wieder aufsetzt. func _on_kill_zone_entered(body: Node3D) -> void: if not body.is_in_group("player"): return - print("Tod am Viadukt — zurück zum letzten Spielstand.") - SaveSystem.reload_last_save() + _respawn_at_checkpoint() + + +## Setzt den Spieler am Checkpoint ab und räumt alle Kräfte weg, die den +## Sturz verursacht haben. +func _respawn_at_checkpoint() -> void: + if _player == null: + return + _qte.cancel() + _player.reset_motion() + _player.global_position = _checkpoint_position + + +## Der aktuelle Respawn-Punkt (für Sonden). +func get_checkpoint_position() -> Vector3: + return _checkpoint_position