###########
# INSTALL #
###########

ZIP: Extract the contents of the ZIP file to your \unrealtournament\system directory.

UMOD: Run the UMOD file, and it will load the installer. If Windows claims it doesn't know what to open a UMOD file with, use 
this utility (http://www.ut-jailbreak.de/Downloads/Zubehoer/Datei/utregfix.exe) to fix the problem.

########
# INFO #
########

WeaponStuff is a small (17KB) mutator that allows you to change properties of weapons.

You can change:
        - Ammo Regeneration Rate
        - Damage Scaling
        - Self-Damage Scaling
        - Momentum Scaling
All on a per weapon basis.

So, for example, you could have the rocket launcher doing negligible damage, yet blowing people miles. Or make the ripper an instant-kill weapon. Use 
the minigun to lift people into the air and keep them there, or set the impacthammer to do normal damage to others, next to none for you, but you can 
jump 7/8th's of the way up a face tower with it!

Note: Self-Damage scaling is applied AFTER Damage scaling.

All is configured through a mod menu.

Select your weapon from the drop-down box, and then adjust the sliders to change the 
properties for that weapon.


################
# Instructions #
################

Clients:
--------
Setting up WeaponStuff for an offline game is easy. Just open the mod menu, and start playing around with the settings.
If you do not configure WeaponStuff before starting play, you wont notice any difference between it and normal UT.

Servers:
--------
WeaponStuff requires a 'ServerPackages=WeaponStuff' line to be added to the server INI file.
When configuring WeaponStuff for a server, you have two options:
        - Set the INI up offline, then copy it over to your server (I suggest you do this, and use the MUTATE commands for adjustments)
        - Use the MUTATE commands as are detailed below
To start a server running WeaponStuff using UCC, use something like:
            UCC Server CTF-Lavagiant?Game=BotPack.CTFGame?Mutator=WeaponStuff.WeaponStuff

Mutate Commands:
----------------
WeaponStuff can be configured through the console with the use of MUTATE commands while you are logged in as administrator.
The syntax is as follows:
            MUTATE WS <RR/D/SD/M> <package.weapon> <value>
Or in longhand (both work):
            MUTATE WeaponStuff <RegenRate/Damage/SelfDamage/Momentum> <package.weapon> <value>
You can mix and match the shorthand and longhand methods.
<package.weapon> refers to the full name of the weapon, ie: Rocket Launcher is botpack.ut_eightball.
<value> can be anything between 5 and 500 for Damage, SelfDamage, and Momentum (the % symbol is left off), and between 0.1 and 20 for RegenRate.
The numbers 0 and -1 have special significance for RegenRate. -1 is the value used for infinite ammo, and 0 is the value used for no regeneration of ammo.
An example is:
            MUTATE WeaponStuff D botpack.shockrifle 250
That sets the ShockRifle's damage scaling to 250%
***IMPORTANT***
If you are running WeaponStuff on the server for the first time, you must use the command:
            MUTATE WS BuildINI
or
            MUTATE WeaponStuff BuildINI
Those commands build an ini file for settings to be written to, if you add another (weapons) mod or mutator - or removed a (weapons) mod or mutator, 
you must run this command (or Offline, just open the menu). It does not erase existing settings.
Building the blank INI file may cause the server to 'freeze' for a split second, this is normal, if you have alot of custom mods on the server it
may take slightly longer.

Using MUTATE commands does not require you to restart the current game for changes to take effect. They take effect on-the-fly.


#########
# NOTES #
#########

I dont promise that this will work with every weapon you may try it on, but it does work
on all default UT weapons, and Wormbo's RocketsUT, and possibly a lot of others

Have fun!

Mutator Page: http://www.wsheppard.pwp.blueyonder.co.uk/william/UT/WS/
Feedback to: Will@byut.net