Name: Ragdoll Madness Beta 2

Authors: Kognefaure (with partial usage of Foxpaw's Ragdoll Injury System on Unrealwiki)

Special thanks to Epic Games and the Unreal community!

Please let the author know if you would like to use or see the source for personnal projects!


1) Installation

2) Mutators Description

3) Known bugs and warnings

4) Improvements and changes since last version



1) Installation:

Extract everything in your UT2004 folder. Everything should go in the right place.

Don't forget to bind a command in your options for the feign death property. (Options -> Input -> Configure Keyboard, section Ragdoll Madness)


2) Mutators Description:


- Ragdoll Madness: Base Mutator

Required mutator to have the "ragdoll feature". It has to be used with Softies! and/or Harpoons.


Configurable options:

> Can't stand up when moving: any player in ragdoll state will have to be lying still in order to recover

> Death shouts: When ragdolling, the player shouts as if dying for real in order to confuse his opponents

> Head view only: locks the view to first person (attached to the head)

> Jump pads madness!: any player that uses a jump pad will be sent in ragdoll state first

> No wall hit damage: horizontal damage is disabled in ragdoll mode, only your vertical velocity do

> Weapon hiding mode: defines what happens to your weapon when entering ragdoll state: it can be hidden, dropped (except when feigning death), or nothing (still visible)

> Feign Death Time: maximum time allowed for feigning death

> Hit Damage Scale: scales the damage you get when hitting a surface (falling, etc)

> Ragdolls stun players: Ragdolls that are propulsed with high velocity can knock down other players. The value defines how long the hit player stay in ragdoll state. If you enter the value 0.0, this feature will be disabled

> Weapons' momentum scale: Scales the impulse of the weapons on the ragdolls



- Ragdoll Madness: Softies!

Players can be knocked down if they receive too much damage in a short period of time.

The mutator works as following: the damages a player get are summed up and dicrease over time. If this sum reaches the "Knock-out damage" option, the victim will be sent into ragdoll state.
The damages dicrease rate can be defined in the "Damage dicrease rate" box (damages per second). The time the player remains knocked down is configured in "Knock-out time".

The other properties, "Only specific damage types" and "Damage type 1, 2, 3 and 4" is more appropriate for advanced users. It allows the knock-down feature to be limited to a few, pre-defined damage types.
By default, these damages are: Falling, Ran over (by vehicle), Shield gun and Monsters (Invasion) melee damage.



- Ragdoll Madness: Physics

Allows you to alter a few physical properties of the ragdolls' behaviour. This mutator also works independtly from the Ragdoll Madness Base Mutator, in which case it will act on dead bodies.

> Air friction (angular and linear): The deceleration of the ragdoll's speed. Angular = rotational speed, linear = "moving" speed

> Gravity scale: speaks for itself

> Ragdoll mass: also acts on the gravity's dependence, but also defines how hard the ragdoll will be moved

> Velocity restitution: The bounciness of the ragdoll. The return of speed it gets when hitting a surface. High value can give strange results!

> World friction: how much the ragdoll will be stopped when gliding on a surface



- Ragdoll madness: Harpoons BETA

Bonus mutator!

Lets you place harpoon traps on any (static) surface or let the level do it in a random way.
The trap will shoot a harpoon once it detects a player. If it hits, the player is dragged quickly toward the trap, smashed against the wall, and dropped repeatedly to crash on the ground.

Shooting a trap will not destroy it, however some weapons are able to enhance it with a special property.

Under some conditions, the harpoon can cause instant death with a special, gruesome death effect.


3) Known bugs and warnings


Warnings: 
Do not use this online. Since UT2004 handles ragdolls only for effects purpose, it's now meant to be played in multiplayer.

Bots won't use feign death.




Known bugs:

Most annoying:

- Bots will be able to get into vehicles even in ragdoll mode. In this case, once the bot recovers from ragdoll mode, he will stand inactive in the middle of the battlefield and the vehicle will be uncontrolled. Fortunately, the bot will respawn.

- Ragdolls that lie on a thin floor above a lava volume (or such) will be damaged by it. Can be disturbing in DM-Deck, for example.


Rare/minor bugs:

- Rare physics crash when entering ragdoll mode with Softies

- The first person view in ragdoll mode can get through the floor

- Death can happen when recovering from ragdoll state right under a ceiling

- Ragdolls sometimes destroy from physics problems (e.g, high impulse on a single bone), in this case, bots don't respawn




4) Improvements and changes since last version:


- No more lava volume crash
- Custom models with special karma set-up should now be compatible (such as Magdalena) However, this has not been tested!
- Ragdolls receive impulse from weapons
- Ragdoll Madness: Weeds renamed Ragdoll Madness: Softies!
- Ragdoll Madness: Softies! now uses a damage-cumulation system, which allows weapons like Minigun or Flak to cause knock-down as well
- vehicles can run over ragdolls
- Players can be pushed and damaged by moving ragdolls, and even knocked-down as well (see "Ragdolls stun players" in "Ragdoll Madness: Base mutator")
