<<<<<<<<<<<<<<<<Kognefaure's Ragdoll Madness beta 1.0 - Unreal Tournament 2004 mutator>>>>>>>>>>>>>>>>>>>>>>>>


Contents:

1) Installation

2) Mutator description

3) Warnings

4) Credits - Copyright & Permission




1) Installation:

Just extract everything except this Readme in UT2004's System folder (should be C:\UT2004/System)

To enable/disable feign death mode in game, first make sure you added Ragdoll madness: Base mutator. You can toggle feign death by writing 'mutate ToggleRagdoll' in the console command (without the ', console command key is Tab), but the easiest way is to bind a key in your UT2004's keyboard configuration (UT2004 options ---> Input---> configure keyboard) in Ragdoll Madness section.


2) Mutator description:

This little script adds in fact three mutators, all based on ragdolls.


 - Ragdoll Madness: Base mutator

This will give the players the possibility to feign death or turn into ragdoll mode in some other cases.
Actually the AI doesn't make any difference with a feign-deathing player and a normal-mode player.
See just above to know how to use the feign death feature.

configurable properties:

>Feign death time: The maximum time allowed to keep feigning death (0.0 = no limit)

>Jump pads madness!: This crazy feature will force every player that use a JumpPad to be turned in ragdoll mode before jumping. Let's feel all the fun of DM-Plunge or DM-Sulphur :)

>Get-up dodge: As a player turn from ragdoll mode to normal mode, he will try to do a little dodge if he doesn't throw himself out of the map. If false, he will just do a little jump.

=====================================================

 - Ragdoll Madness: Weeds

The players will be more sensible with some type of attacks and fall down of pain.
YOU MUST ADD the previous Base mutator if you want this one to work!

configurable properties:

>Fall-down damage: The minimal amount of damage that will make a player fall.

>RagdollDuration: The time a fallen player will stay down.

>Only specific damage types: If true, the players will be sensible only with the four following damage types.

description of the defaults damage types set (they could be difficult to configure; only for advanced users):

Damage Type 1: Class'Engine.fell'                  --> when a player take falling damage. Funny and realistic results :)
Damage Type 2: Class'Onslaught.DamTypeRoadkill'    --> when a vehicle run into a player. So they will be more difficult to kill by running into them.
Damage Type 3: Class'XWeapons.DamTypeShieldImpact' --> The Shield gun's damage type. To make melee fights more attractive.
Damage Type 4: Class'SkaarjPack.MeleeDamage'	   --> Monster's melee damage. Funny results with big monsters. Just try with Unreal 4 ever's Goro :)

=====================================================

 - Ragdoll Madness: Physics

This complex mutator will allow you to modify the ragdolls physics properties. You can edit it in a funny, realistic or what way you want. 


>Air friction(angular vel): Difficult to explain. This value adds resistance against angular velocity of ragdolls. <0.0 = ragdolls rotating faster and faster, ~0.0 = No or little dicrease of rotating velocity, >7.0 = Ragdolls look like moving statues

>Air friction(linear vel): Difficult to explain too. This value adds resistance against linear velocity of ragdolls. <0.0 = ragdolls accelerating while they're in air, ~0.0 = No dicrease of velocity, >7.0 = Difficult to move a ragdoll: it will immediately stop.

>Gravity scale: Ragdolls' dependance of gravity.

>Ragdoll Mass: The simulated mass of the ragdolls. High value = difficult to move a ragdoll, it will look very heavy.

>Velocity restitution: The bounciness of ragdolls. <0.0 = No bounces, 1.0 - 2.0 = little moves of arms and legs and powerful bouncing, >6.0 = Flubber-mode ;)

>World Friction: The bodies friction with the world's geometry. <0.0 = Ragdolls gliding on the ground, 1.0 = smoothed velocity dicrease, >2.0 = high friction: ragdolls will stop very strongly when they hit something and could get stuck easily in some objects.







3) Warnings:


The feign death (and every ragdoll-mode of this script) are NOT tested online. In fact, there is an extremely low probability of working in multiplayer game. Hosting the Ragdoll madness: Base mutator (or weeds) on an online server is at your own risk.

There are some bugs linked to the physics engine use and maybe critical errors (critical errors just close the game).

The mutator should work with any other mod, but again as it wasn't tested with all of them so there can be conflicts and/or bugs.


4) Credits - Copyright & Permission

Script created by Kognefaure with the help of FoxPaw's karma ragdoll injury system on UnrealWiki, and of course Epic games for their great game: UT2004 =D

If you want to use a part or the whole script for any project, please first get the author's permission (Kognefaure) for example with a private message on www.unreal-design.com or on any forum the author released this. 




===================================================================

FRENCH README/Lisez-moi

Contenu:

1) Installation

2) Description du mutator

3) Mises en garde

4) Crdits - Copyright & Permissions




1) Installation:

Extraire tout les fichiers hormis ce Lisez-moi dans le dossier systme d'UT2004 (devrait tre C:\UT2004/System)

Pour activer/dsactiver le mode feign death, assurez-vous d'abord d'avoir ajout Ragdoll madness: Base mutator dans votre partie. Activez/dsactivez le feign death en crivant 'mutate ToggleRagdoll' dans la console (sans les ', la touche pour la console est Tab), Mais la manire la plus simple est de configurer une touche dans les options clavier d'UT2004 (options d'UT2004 ---> Prfrences---> configuration clavier) dans la section appele Ragdoll Madness.


2) Description du mutator:

Il y a en ralit 3 mutators ajouts avec ce script, le tout gnralement bas sur la simulation physique des ragdolls.


 - Ragdoll Madness: Base mutator

Donne la possibilit de passer en mode ragdoll, que ce soit par feign death ou autre moyen.
Pour le moment, l'IA ne fait pas usage du feign death ni ne fait la diffrence entre un joueur en mode ragdoll et un joueur en mode normal.
Voir ci-dessus pour savoir comment utiliser le feign death.

Proprits configurables:

>Feign death time: le temps maximum pour rester en mode feign death (0.0 = pas de limit)

>Jump pads madness!: Si cette option est coche, tout joueur essayant d'utiliser un JumpPad passera de force en mode ragdoll avant d'tre projet par le JumpPad. Dcouvrez enfin tout le fun de DM-Plunge et DM-Sulphur :)

>Get-up dodge: Si coch, un joueur passant du mode ragdoll au mode normal fera une esquive en essayant de ne pas se jeter hors de la map. Si dcoch, il fera simplement un saut.

=====================================================

 - Ragdoll Madness: Weeds

Rend les joueurs plus sensibles  certains dgts; ils tomberont si ils sont touchs.
IL FAUT LE MUTATOR PRECEDENT AJOUTE ET ACTIF dans une partie pour que celui-ci fonctionne!

Proprits configurables:

>Fall-down damage: Un joueur tombera s'il prend plus que ce nombre de dgts.

>RagdollDuration: Le temps mis par un joueur tomb pour se relever.

>Only specific damage types: Si coch, les joueurs ne seront sensibles qu'aux 4 types de dgts ci-desssous

Description des types de dgts par dfaut (Ils peuvent tre difficiles  configurer; rserv aux utilisateurs avancs):

Damage Type 1: Class'Engine.fell'                  --> Lorsqu'un joueur prend des dgts ds  une chute. Rsultats funs et ralistes :)
Damage Type 2: Class'Onslaught.DamTypeRoadkill'    --> Lorsqu'un vhicule crase un joueur.
Damage Type 3: Class'XWeapons.DamTypeShieldImpact' --> Le type de dgt du marteau bouclier. Pour rendre plus attirants les combats de mle.
Damage Type 4: Class'SkaarjPack.MeleeDamage'	   --> Type de dgts des monstres au corps--corps. Rsultats funs avec les gros monstres (genre le Goro d'Unreal 4 ever) :)

=====================================================

 - Ragdoll Madness: Physics

Mutator compliqu permettant de configurer les proprits physiques des ragdolls. Vous pouvez ainsi les modifier de faon raliste, fun ou tout ce que vous voulez.


>Air friction(angular vel): Difficile  dcrire: cette valeur ajoute de la rsistance  la vitesse de rotations des ragdolls. <0.0 = Les ragdolls tournent toujours plus vite, ~0.0 = Trs petite ou pas de dclration dans la vitesse de rotation , >7.0 = les ragdolls ressemblent  des statues en mouvement

>Air friction(linear vel): Tout aussi dur  dcrire. Plus cette valeur est basse et plus les ragdolls acclreront en vol. A l'inverse, ils vont sembler freiner en l'air. <0.0 = Les ragdolls acclrent toujours plus en vol, ~0.0 = Pas de dclration ni acclration, >7.0 = Les ragdolls s'arrtent trs rapidement: difficile des les faire bouger.


>Gravity scale: La dpendance des ragdolls  la gravit.

>Ragdoll Mass: La masse des ragdolls. Valeur haute = Les ragdolls sembleront trs lourds; difficile de les faire bouger aussi.

>Velocity restitution: L'lasticit des ragdolls: leur facilit  rebondir. <0.0 = Aucun rebond, 1.0 - 2.0 = Rebonds puissants et petits mouvements des membres, >6.0 = Les ragdolls ne s'arrtent jamais; ils rebondissent sans arrt, rappellant un peu Flubber ;)

>World Friction: La force de frottement des corps. <0.0 = Les ragdolls glissent sur le sol, 1.0 = Les ragdolls freinent doucement sur le sol, >2.0 = Frottement puissant: les ragdolls freineront rapidement lorsqu'ils glissent sur une surface et pourraient se coincer dans certains objets.







3) Mises en garde:


Le feign death (comme chaque mode ragdoll de ce script) n'a pas t test en ligne. Il y a de trs faibles probabilits que le mutator fonctionne en multijoueur. Utiliser Ragdoll madness sur votre serveur multijoueur est  vos propres risques.

Prsence probable de bugs lis  l'usage du moteur physique d'UT2004. Il pourrait mme y avoir des erreurs critiques (les erreurs critiquent ont pour effet de quitter le jeu).

Le script devrait tre compatible avec n'importe quel autre mod mais n'exclut pas des bugs et conflits voire infonctionnalit. L'usage d'un ou plusieurs autres modules avec Ragdoll madness est  vos risques.




4) Crdits - Copyright & Permissions

Script cre par Kognefaure avec l'aide du systme de mode-ragdoll de FoxPaw sur UnrealWiki, et bien sr Epic games pour leur jeu norme: UT2004 =D

Si vous voulez rutiliser une partie ou tout le script pour un projet quelconque, merci de demander la permission  l'auteur (Kognefaure) par exemple avec un message priv sur www.unreal-design.com.
