RagdollDown

In Easy Red 2, a soldier who is only INCAPACITATED (wounded, still alive,

rescuable by a medic) does not fall over like a body - he slowly lies down,

locked inside an animation, until somebody rescues him or he bleeds out.

Deaths are already ragdolls; incapacitation is not.

This mod replaces that stiff "controlled by the animation" fall with a real

physical ragdoll, so a wounded soldier collapses under physics the same way

a dead one does - while still being fully rescuable by a medic.

HOW IT WORKS

------------

- The moment a soldier becomes incapacitated, the mod hands his skeleton over

to the game's own ragdoll system (the same call the game uses for corpses)

and stops the animation from driving the bones.

- The body keeps the posture it was actually in (standing, crouching or prone)

and collapses from there under real physics.

- The animation is silenced in the LateUpdate phase, which is the only place

where it cannot be re-enabled behind our back before the frame is drawn.

- When a medic treats him, the body is handed back to the game and the

original animation state is restored from a ledger of recorded values, so he

stands up and walks normally again.

The wounded soldier remains a normal, living, rescuable unit the whole time.

Bleeding out, death, and medic behaviour are untouched.

Dragging (F) uses the game's own native drag animation. The mod steps aside

while a body is being carried and hands it back to the game, then turns it

into a ragdoll again when you let go.

prone variant, regardless of the posture the soldier was in when he went down.

That is intentional.

WHAT THIS MOD DOES NOT DO

-------------------------

- It does not change death. Dead soldiers already ragdoll in vanilla.

- It does not change how long incapacitation lasts, or how bleeding out works.

- It does not touch other soldiers - only the one being incapacitated.

enabled                - master switch (default: true)

incapacitatedRagdoll    - the core feature (default: true)

- only needed when reporting a problem

verboseLog              - detailed per-takeover log lines (default: false)

stateSnapshot          - print ragdoll state at takeover/restore

(default: false)

boneDriftProbe          - log whether the bones move as expected

(default: false)

All diagnostics default to OFF: normal play produces only a few log lines.

INSTALLATION

------------

1. Requires BepInEx 6 for IL2CPP (Easy Red 2).

2. Copy ER2_RagdollDown.dll into <Game>\BepInEx\plugins\

3. Launch the game once. Settings live in

<Game>\BepInEx\config\er2.ragdolldown.cfg

(an in-game Mod Manager page can edit them if you use one).

COMPATIBILITY

-------------

- Fully reversible: no vanilla files are modified. Delete the DLL to uninstall.

- Only three game methods are hooked, all postfix-only: the incapacitation

entry point, the death cleanup, and the destroy cleanup. No original logic is

skipped or altered, so wound handling, bleeding out, and medic targeting all

behave normally.

- Other mods that treat "has a ragdoll" as a synonym for "is dead" may need a

closer look: with this mod installed, "alive but ragdolled" becomes a normal

state. A correct check for a corpse should use the game's own IsDead flag.

- Known limitation: this mod was developed and tuned against the vanilla

incapacitation behaviour. If another mod changes when or how incapacitation

happens, the two may not cooperate.

KNOWN ISSUES

------------

- When a soldier is rescued, the arm animation may twitch. This is vanilla

behaviour, not caused by this mod: it happens when a soldier is shot down

while in the middle of the bandaging animation, and the game resumes that

animation after the rescue. Reproducible without this mod installed.

- First public release.

- Incapacitated soldiers fall as real physical ragdolls instead of playing

the scripted lie-down animation.

- The body keeps the posture it went down in, and is not snapped to a

standing or bind pose at any point.

- The animation is silenced from LateUpdate so it cannot drive the bones on