Built for the Minewache roleplay server. When a player's health drops too low they collapse into a fully simulated ragdoll — they flop, tumble, slide down stairs and stay down until revived.
On 1.20.1 the mod is fully standalone: it ships with its own Bullet physics engine and its own UI, so no DynamX and no ACsGuis are required. (The original 1.12.2 build uses DynamX for physics — see Legacy below.)
Injury System
When health drops to a critical threshold, the player is downed and becomes an invisible, fully physical ragdoll. A custom death GUI appears with Revive / Respawn / Exit. The player stays down until:
- Another player right-clicks them with a First Aid Kit
- An admin uses
/revive <player> - The respawn timer elapses and they respawn
The ragdoll is launched with knockback from the direction the player was hit.
Physics & Interaction
- Real collisions — ragdolls collide with the terrain, with blocks, and with other players, settling naturally on stairs, slabs and slopes.
- Reacts to the world — mine the block beneath a ragdoll and it falls; explosions fling it away instead of deleting it.
- Grab & lift — hold the grab key (default V) and look at a ragdoll to drag a limb around; the rest of the body follows. Rebindable under Controls → Saros Ragdoll.
- Hit to remove — a direct melee hit (e.g. in creative) removes a ragdoll.
- Physics feel — choose
smooth(calm, settles naturally) orfloppy(raw and loose) in the config.
Commands
| Command | Description |
|---|---|
/saros_spawn_ragdoll [player] |
Drop a free ragdoll showing that player's skin in front of you (nobody is downed) |
/saros_spawn_ragdoll death [player] |
Put a player into the (invisible) ragdoll / death state + death UI |
/saros_spawn_ragdoll kill |
Remove all ragdolls |
/revive [player] |
Heal and stand up a downed player (restores full health + food) |
/respawn [player] |
Drop items (per config) and respawn |
/instantragdoll <player|all> <on|off> |
Toggle ragdoll-on-hit for a player (bypasses the health threshold) |
Configuration
config/saros_ragdoll-common.toml:
| Option | Default | Description |
|---|---|---|
PhysicsMode |
smooth |
Ragdoll feel: smooth (angular damping) or floppy (raw, no damping) |
ReviveItem |
saros_ragdoll:firstaidkit |
Item required to revive |
RequireOPForRevive |
true |
Restrict /revive to OP |
DropItems |
DropWhenRespawn |
When to drop inventory: NoDrop, DropMainHand, DropWhenGetInRagdoll, DropWhenRespawn |
RespawnTimer |
62 |
Seconds until the Respawn button activates (0 = disabled) |
ToggleRagdollGUI |
true |
Show the GUI when entering ragdoll |
ShowExitButton / ShowReviveButton / ShowRespawnButton |
true |
Toggle each death-GUI button |
debug |
false |
Verbose ragdoll / physics / native logs |
Items
| Item | Description |
|---|---|
| First Aid Kit | Revive a downed player (right-click) |
Dependencies
- 1.20.1: none — fully standalone (bundles its own physics engine).
- 1.12.2: requires the DynamX Mod.
Legacy — 1.12.2 (DynamX edition)
The original 1.12.2 build runs on DynamX. It adds a vehicle-collision system on top of the ragdoll: DynamX vehicles deal damage on contact, scaling with the vehicle's speed (configurable BaseDamage, SpeedMultiplier, MinSpeedBps, MaxDamage). This system does not exist in the standalone 1.20.1 build.
Showcase
Note: This wiki serves as documentation. For active discussion, please join the Discord Server.
