-------------------------------------------------------------------------------
               NIUT Mutator for UT (No Item Unreal Tournament)
-------------------------------------------------------------------------------
               
Version: 1.0 final (unless changes needed for UT release version)
Created: 11/05/99
Author:  Mike Fox (a.k.a. ArtfulDodger)
Contact: mfox@legendent.com
URL:     www.planetunreal.com/niu

Overview
--------

Everyone plays with the same weapon and has more or less the same items at all
times. This makes the game play focus on combat skills, rather than item
gathering and controlling. Most matchups will be very even and the winner will
be the one who makes the best use of the current weapon / items. If you are
killed, it *won't* be because the other guy has a better weapon or the power
armor etc.

The addition of random jumpboots, invisibility and power amplifiers (to all
players at once) makes for some interesting situations...

Note: Unlike NIQ for Q2 (see www.planetquake.com/niq), ammo isn't incremented
automatically. In testing it actually seemed to work better to simply turn all
pickups in the level into ammo for the current weapon. Nobody should ever run
out of ammo and this makes players go into areas which they might not otherwise.

Features 
--------

Everyone plays with the same weapon at all times.

Weapon changes every X seconds.
 
Weapon is chosen from a configurable list of weapons and this *should* work with
any Weapon-derived classes, even non-UT weapons (including the Unreal weapons,
although this hasn't been tested yet).

Weapons are selected randomly or sequentially.

If weapons are selected randomly can optionally force all weapons to be used at
least once before restarting the selection process.

Replaces all pickup items in the level with ammo for the current weapon. If
the current weapon doesn't require ammo, uses health vials. Flags, runes
etc. and the translocator aren't affected.

Plays a warning sound just before weapon is changed.

To have some weapons used more frequently that others, just put these in
WeaponClassStrings more than once (see below).

Can optionally have the server increment everyone's health automatically.

Can optionally have server give everyone jumpboots, invisibility and/or the
damage amplifier at random times and for random durations.

Should work with most other mutators, including the Fatboy mutator.

Should work with most gametypes (CTF, Domination).

Works with bots.
 
Installation
------------

After installing NIUT, you should end up with the following files in your UT
system folder:

    niut.ini    NIUT configuration file
    niut.int    mutator information
    niut.txt    this file
    niut.u      NIUT mutator code

Fire up UT and start a practice session or multiplayer game. Click on the
mutators button and make sure the NIUT mutator is included (right-hand pane)
along with any other mutators that you want to use.

The following settings with the indicated defaults can be modified in niut.ini:

[NIUT.NIUTMutator]
// list of weapons to use in the game (can be in any order but don't skip a #)
// add a weapon 2x or more to have it appear more frequently
WeaponClassStrings[0]="Botpack.UT_Eightball"            
WeaponClassStrings[1]="Botpack.PulseGun"
WeaponClassStrings[2]="Botpack.ShockRifle"
WeaponClassStrings[3]="Botpack.MiniGun2"
WeaponClassStrings[4]="Botpack.SuperShockRifle"
// weapons are selected randomly (if false weapons are selected in order)
bRandomWeapons=true
// if random weapons, causes all weapons to be used once before restarting
bUseAllWeapons=true
// min/max time between weapons switches
TimeBetweenWeaponSwitchesMin=60.0
TimeBetweenWeaponSwitchesMax=60.0
// switch warning sound
WarningSound=Sound'Botpack.Pickups.UTSuperHeal'
// number of times to play switch warning sound
WarningSoundRepeats=3
// seconds between health increments
TimeBetweenHealthIncrements=1
// amount to increment health by (use 0 to disable incrementing health)
HealthIncrementAmount=5
// sound to play when incrementing health
HealthIncrementSound=
// min/max delay between giving invisibility to all players
InvisibilityDelayMin=45.0
InvisibilityDelayMax=75.0
// min/max duration for invisibility
InvisibilityDurationMin=15.0
InvisibilityDurationMax=15.0
// min/max delay between giving damage amplifier to all players
DamageAmplifierDelayMin=30.0
DamageAmplifierDelayMax=45.0
// min/max duration for damage amplifier
DamageAmplifierDurationMin=15.0
DamageAmplifierDurationMax=15.0
// min/max delay between giving jump boots to all players
JumpBootsDelayMin=30
JumpBootsDelayMax=60
// min/max duration for jump boots
JumpBootsDurationMin=20.0
JumpBootsDurationMax=20.0

Weapon Types
------------

Here's a list of Weapon Types which can go in WeaponClassStrings. Not all of
these are available in the UT demo and some of these may require prefix
UnrealShare or UnrealI instead of Botpack.

Translocator
ChainSaw
ImpactHammer
enforcer
SuperShockRifle
doubleenforcer (comes up as a regular enforcer?)
ut_biorifle
SniperRifle
ripper
minigun2
ShockRifle
PulseGun
UT_FlakCannon
UT_Eightball
WarheadLauncher

