A player drops past the health threshold and goes down as a physics ragdoll. They flop, tumble, slide down a flight of stairs, and stay where they land until somebody revives them or the respawn timer runs out. Built for the Minewache roleplay server, where dying instantly and respawning at a bed ruins the scene.
From 1.20.1 on the mod is standalone. It ships its own Bullet physics engine and its own UI, so it needs neither DynamX nor ACsGuis. Only the 1.12.2 build still runs on DynamX, described under Legacy below.
Injury system
At a critical health threshold the player goes down and turns into an invisible ragdoll that the physics engine takes over. A death GUI opens with Revive, Respawn and Exit. The player stays down until one of three things happens:
- Another player right-clicks them with a First Aid Kit
- An admin uses
/revive <player> - The respawn timer elapses and they respawn
The ragdoll flies off in the direction the hit came from.
Physics and interaction
- Real collisions. Ragdolls hit terrain, blocks and other players, and settle on stairs, slabs and slopes.
- Reacts to the world. Mine the block under a ragdoll and it drops. An explosion throws it instead of deleting it.
- Grab and lift. Hold the grab key (default V) and look at a ragdoll to drag a limb around. The rest of the body follows. Rebind it under Controls, Saros Ragdoll.
- Hit to remove. One direct melee hit, in creative for example, deletes a ragdoll.
- Physics feel.
smoothsettles down quietly,floppystays raw and loose. Set it 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 and newer: none. The physics engine ships with the mod.
- 1.12.2: needs the DynamX mod.
Legacy 1.12.2 (DynamX edition)
The 1.12.2 build runs on DynamX and has one thing the newer builds do not: vehicle collisions. A DynamX vehicle hurts whoever it hits, scaled by its speed through BaseDamage, SpeedMultiplier, MinSpeedBps and MaxDamage.
Showcase
Note: This wiki is the documentation. Questions and bug reports are faster on the Discord server.
