godot-mechanic-revival

name	godot-mechanic-revival
description	Expert blueprint for player mortality loops: progress-index checkpoints, soul graves, ghost/spirit layers, I-frame restitution, world-progress persistence, and death analytics. Use when implementing respawn, shrine checkpoints, corpse-run retrieval, or second-chance mechanics. Keywords revival, respawn, checkpoint, soul grave, ghost mode, I-frames, death analytics, progress index.

Overview

Mortality beyond Game Over: progress-index checkpoints, soul graves, ghost/spirit collision layers, I-frame restitution, world-progress bitmasks, and death analytics (Sekiro / Hades / Souls-like).

Golden Path — Death → Fade → Restore → I-frame → World Persist

MANDATORY script order (read before improvising):

1. revival_global_manager.gd — Autoload owns death → delay → respawn; resolve player via group Player.
2. revival_death_timer.gd — 1–2s fade / death anim; never snap-respawn.
3. revival_state_reset_guard.gd — zero velocity / clear locks before teleport.
4. revival_health_restitution.gd — health restore + I-frames.
5. revival_checkpoint_persistence.gd — write world-progress bitmask to user://. Optional layers: revival_soul_grave.gd, revival_ghost_mode.gd, revival_death_analytics.gd.

NEVER Do (Expert Revival Rules)

Lifecycle & State

• NEVER respawn the player with existing velocity — Always zero out and in or the player will fly into a wall upon respawning.