CR 20: Viadukt respawnt am Checkpoint statt am Spielstand

Der Sturz in die Nebelschlucht setzt Tyrveil jetzt am zuletzt erreichten
Checkpoint wieder ab — ohne Szenenwechsel, ohne Laden. Wurde noch keiner
beruehrt, beginnt der Lauf am Steganfang. Damit verhalten sich die beiden
Set-Pieces mit Checkpoints gleich; reload_last_save() bleibt den Story-Toden
vorbehalten, Tag-9-Hinterhalt und Dreschen-Pruefung. SPEC §6 haelt die
Checkpoint-Ausnahme jetzt fest.

Player.reset_motion() loescht beim Respawn Geschwindigkeit und Fremdschub,
damit der Sturzimpuls nicht mit auf den Steg zurueckkommt.
BalanceQTE.cancel() bricht ein noch laufendes QTE ueber einen
Generations-Zaehler ergebnislos ab — sonst haette die wartende Coroutine den
frisch abgesetzten Spieler sofort wieder heruntergestossen.

Dabei aufgefallen und nach Autoren-Entscheidung mitbehoben: Der Wind wirkte
als Beschleunigung statt als Zusatz-Geschwindigkeit. player.gd addierte
external_push pro Frame, waehrend die Abklingrechnung im Stillstand den
Windanteil des Vorframes erneut einlas — die Seitwaertsgeschwindigkeit lief
von 0 auf -21 m/s in einer Sekunde davon, bei konstantem Schub von -0,7. Der
Fehler war Altbestand und nur unsichtbar, weil der Tod bisher die Szene neu
lud; mit dem Checkpoint-Respawn haette er sofort wieder heruntergeblasen.
_process_normal() zieht den zuletzt angewandten Schub jetzt zu Frame-Beginn
ab. Gemessen danach: konstant 0,70 m/s, 1,07 m Versatz in 1,5 s. Das Viadukt
wird dadurch spuerbar gutmuetiger.

Gauntlet unveraendert.

Verifiziert mit dev_cr20_probe (19/19) und einem Boot-Check ueber acht
Szenen; Sonde vor dem Commit geloescht.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-21 18:46:48 +02:00
parent b911f243be
commit cba2dfe1ec
7 changed files with 141 additions and 46 deletions

View file

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

View file

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

View file

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

View file

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

View file

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

View file

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

View file

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