Smiling Monsters Regen mutators for Unreal Tournament
Version : Beta 1B
Author: TheWatcher
Released: 14/07/2007

Distributed under the terms of OpenUnrealMod license - see LICENSE.txt for details

What does it do
===============
This package contain two mutators that regen health and weapon ammo. The regen health increase health to a set level when a player is hurt and the regen ammo mutator increase ammo when it is below the maximum ammo.

The mutator have been made to enhance MonsterHunt because it can take a long time to find health and ammo when there are many players. It can also be used with other gametypes. This version is a beta but it should work with no problem on a dedicated server.

Installation
============
To use offline put the files in your System folder. To use on a server War_Master say that it is not necessary to put the mod in the serverpackages. I confirm this.

To run the mutator on a server load them in the webadmin or enter this command as admin.

admin servertravel MH-d1?game=MonsterHunt.MonsterHunt?Mutator=SMoRegenBeta1B.SMoRegenAmmo,SMoRegenBeta1B.SMoRegenHealth

For mapvotela the name of the mutator to use are SMoRegenBeta1B.SMoRegenAmmo and SMoRegenBeta1B.SMoRegenHealth.

Config
======
You can config the mutators via the ini file. Here are what the values do :

bRegenAmmo          - Leave this to true. It is extra code that will be used in the next version.
PlusAmmo            - How much to increase the ammo. This increase is set each second.
bExcludeRedeemer    - If True does not regen ammo of redeemer.
bExcludeOtherWeapon - If True you can exclude the ammo regen of other weapon.
ExcludeAmmo[0-9]    - You can define a maximum of 10 ammo to be excluded. "rlammo" is the ammo used by the RocketL of WhitePalace. You can find the name of other ammo by using UnrealEd. If there is demand I will add a debug option so you can find the name of the ammo in UnrealTournament.log.

bRegenHealth        - Leave this to true. It is extra code that will be used in the next version.
PlusHealth          - How much to increase health. This increase is set each second.
RegenHealthLimit    - Tell the mutator up to how much health it must regen. If you set this to higher than 100 this will work like MaxHealth in old version and increase the standard health of a player.

You can set these variables via the console. For example to change PlusAmmo:

set SMoRegenBeta1B.SMoRegenAmmo PlusAmmo 1.5

Changes
=======
1.0BetaB - [Fixed]   Accessed none.
         - [Fixed]   Incorrect regen when ExcludeAmmo is true.

1.0BetaA - [Added]   Option to exclude ammo from other weapon.
         - [Added]   MaxHealth variable now replace RegenHealthLimit.
         - [Changed] Floor function changed so it will give correct return.
         - [Fixed]   Only one mutator working and not other.
         - [Fixed]   Incorrect Addvalue that stop regen working.

1.0Beta  - [Changed] Regen mutators made into one package.
         - [Added]   Config variables and ini file.

x.x      - First version of regen mutators

Archive contents
================
Help
|- README.txt - You are reading this :)
|- LICENSE.txt - OpenUnrealMod License. Please read this so you know what you can do with this mod.
System
|- SMoRegen.ini - Ini file use by mutators. Please replace the old SMoRegen.ini with this one !
|- SMoRegenBeta1A.int - Ressource file so UT find the mutator. 
|- SMoRegenBeta1A.u - Package containing the regen mutator.

Thanks to
=========
- War_Master: For the suggestion to exclude other ammo beside redeemer, for showing the problem with version Beta 1 and Beta 1A. Also for the alternative code.
- Wormbo: For information on config variable, for the method used in the regen code and showing some code that cause accessed none.
- [SAS]Solid Snake: For showing that the floor function did not give good result.
- The people of the SMo community for testing the mod.

Contact
=======
If you find any bugs or have some suggestions please contact me.

contact@monsters.clansmiley.com

Community
=========
If you like playing UT for fun visit the Smiling Monsters community at http://www.smiling-monsters.com/community/. We have a public server at the IP 82.94.228.101. All are welcome but be nice and respect the rules ;) .