BetterRagdollEnhanced

BetterRagdollEnhanced

English | 中文

Based on BetterRagdoll by Luluberlu.

English

BetterRagdollEnhanced lets you press X on keyboard or LB on controller to ragdoll with a push in your current movement direction. Hold the button to stay ragdolled, move the mouse horizontally to roll, then release it to get back up.

The project originally aimed to provide more flexible movement while ragdolled, but stable physical control across different poses and ground contacts proved more complex than expected. For now, the scope is intentionally limited to grounded side rolling, with broader movement deferred.

Highlights

• Ragdoll on demand: Tap the configured key to enter a short, responsive ragdoll.
• Movement-based push: Moving characters receive a push in their current velocity direction.
• Hold to stay down: Keep holding the key to remain ragdolled without sending an RPC every frame.
• Physical side rolling: Move the mouse or right stick horizontally to roll the ragdoll clockwise or counterclockwise without restoring normal character control.
• Keyboard, mouse, and controller support: Uses PEAK's current Unity Input System with configurable X/LB defaults.

Installation

Install Mod Manager or r2modman, or place BetterRagdollEnhanced.dll directly in PEAK's BepInEx/plugins/BetterRagdollEnhanced directory. BetterRagdollEnhanced requires BepInEx 5.

BetterRagdollEnhanced replaces the original BetterRagdoll. Remove BetterRagdoll.dll before installing; the two plugins are declared incompatible and should not be loaded together.

Controls

| Action | Keyboard | Controller |

|---|---|---|

| Trigger a short ragdoll | X | LB |

| Stay ragdolled | Hold X | Hold LB |

| Roll while ragdolled | Move mouse left / right | Right stick left / right |

The short-press behavior intentionally preserves the original feel: the fall lasts 0.5 seconds, the default push force is 322, and the push uses the character's full average velocity direction.

While grounded, move the mouse or right stick horizontally to roll toward the matching screen side. Direction stays stable as the body and camera turn. Rolling is available only during a ragdoll started by BetterRagdollEnhanced; ordinary falls, knockouts, death, and airborne movement remain uncontrolled.

Ragdoll input pauses while a menu or input wheel is open. If the key is held while input becomes blocked, release it before triggering ragdoll again.

Configuration

The config file is generated at BepInEx/config/com.github.lllei.BetterRagdollEnhanced.cfg.

| Key | Default | Description |

|---|---:|---|

| Settings.Ragdoll Force | 322 | Push force applied when ragdoll starts while moving |

| Settings.Keyboard Ragdoll Key | /x | Input System control path for the keyboard or mouse trigger |

| Settings.Gamepad Ragdoll Key | /leftShoulder | Input System control path for the controller trigger (LB by default) |

| Ragdoll Movement.Enabled | true | Enable grounded rolling during ragdolls triggered by this mod |

| Ragdoll Movement.Roll Acceleration | 30 | Maximum angular-speed change per second (0 to 200) |

| Ragdoll Movement.Max Roll Speed | 4 | Target side-roll speed in radians per second (0.1 to 15) |

| Ragdoll Movement.Mouse Roll Sensitivity | 2 | Horizontal mouse input scale (0 disables mouse rolling, up to 2) |

| Ragdoll Movement.Mouse Roll Strength | 5 | Mouse-only roll acceleration multiplier (0 disables mouse rolling, up to 10) |

| Ragdoll Movement.Gamepad Roll Sensitivity | 1 | Horizontal right-stick input scale (0 disables gamepad rolling, up to 2) |

| Ragdoll Movement.Gamepad Roll Strength | 3 | Right-stick roll acceleration multiplier (0 disables gamepad rolling, up to 10) |

Sensitivity controls how much mouse or right-stick movement reaches full roll input. Strength controls how quickly that device accelerates the ragdoll toward the configured roll speed. Both inputs are clamped to the same -1 to 1 range before reaching the motor, but mouse delta is an impulse while right-stick position is co