Files
EscapistsReintroduced/docs/recovery.md
T

2.6 KiB

Revivable players and all-unconscious mission failure

Admitted player bodies receive server-owned casualty protection. Ordinary damage still causes wounds and bleeding. Damage to physical, overall-health and blood hitzones is limited above their configured destruction threshold; an otherwise lethal hit knocks the prisoner unconscious. Resilience can still reach zero, and healing damage is passed through unchanged. Further hits and bleeding cannot finish the casualty. AI retain their normal damage rules. Protection stays with the original body across reconnects and does not grant a new life or respawn.

The round fails after 30 uninterrupted seconds with every remaining prisoner unconscious, no conscious reserved prisoner available to reconnect, and no ongoing treatment or observed blood/resilience recovery. Waking up, a treatment in progress, or increasing blood/resilience resets that timer. A passive recovery effect that is present but makes no progress does not prevent failure. An empty server does not start this timer. Mission status explains whether recovery is continuing or the team is in the failure grace period.

Treatment uses the existing medical system. Bandaging and saline remain relevant; ACE Medical epinephrine heals resilience and is not blocked by casualty protection. ACE's own treatment prerequisites still apply (including stopping bleeding and restoring sufficient health). Installing this mission does not itself install ACE Medical or add an unlimited epinephrine action.

/esc mission abandon remains an administrator-only way to end a round explicitly. The all-dead/missing-body fallback and exhausted-admission handling also remain, for deleted bodies and administrative/native paths outside ordinary damage.

The isolated recovery Workbench fixture exercises damage exceeding full health on health, blood and head hitzones, continued survival while treatment is flagged active, restoration by native resilience healing, and the actual all-unconscious failure timer. This is separate from remote-client/manual treatment acceptance.

Validation on 2026-09-23: all repository checks passed after updating the existing ServerTick test adapters. The isolated recovery run at /tmp/erri-revivable-native2/logs/logs_2026-09-23_20-02-04 completed 66 assertions with no script/runtime failures, unchanged source and verified cleanup. Existing RHS/WCS resource and inherited prefab-keyword errors remain in that engine log. The recovery effect was a native timed resilience-healing effect; an actual ACE injector action and remote multiplayer treatment were not exercised by this run.