Protector Mutator for UT

(c) 1999,2000 Armando Andrea BARLAAM "Major Disaster"

Version: 2.30
Created: 22/01/00
Author: Armando A. Barlaam (Major Disaster)
Contact: mdisaster@ngi.it
Homepage: Major Disaster UT Pages

This software is unsupported and you use it at your own risk. I am not responsable of whatever may happen if you use it.




Table of contents
Legal Info    
Overview    
New in this version    
Installation    
Getting started    
Configuration options    




Legal Info
You may:
- Install Protector on UT servers for others to play.
- Put Protector on public internet server for downloading, as long the original file is unaltered.
Any other use requires my written consent (this includes, but is not limited to, distributing Protector alone or bundled with other software, and including Protector in any form of distributable media, whether it is free or not).




Overview
This server-side mutator makes all players and bots invulnerable for some seconds after respawn, in order to discourage respawn campers.




New features in this version
-Added: GUI interface, Protector options can now be set from the Mod menu.
-Added: Translucency is now optional.
-Added a translucency slider control
-Added the fast loading feature (effective only in UT 4.30 or later)
-Added optional respawn protection from Assault cannons
-Added selective protection for humans, bots or both
-Added optional dynamic protection: protection will expire in advance if the protected player grabs a weapon or powerup
-Removed: the kick voting system, for better compatibility with dedicated voting mutators such as UTCV.
-Changed: Protection time can now be from 0 to 15 seconds
-Changed: Protected players no longer glow
-Changed: The package name is now Protector230, to avoid problems with auto download. -Fixed: Workaround for the translucency bug in Epic code (sometimes playes stayed translucent)
-Documentation updated.



Installation
Uninstall previous versions
You should uninstall the previous version of Protector before or after installing 2.30:
Either open Control Panel/Install-Remove Application, doubleclick on "Unreal Tournament" and select the Checkbox near "Protector", or just remove these files from c:\unrealtournament\system :
protector.u
protector.int
protector.ini

from c:\unrealtournament\help :
protector.txt

Also make sure to remove any ServerPackages=Protector.u from unrealtournament.ini (there shouldn't be one anyway)
If you don't, you'll have two Protector mutators installed. This will not harm your UT installation, but it's boring ;)

Install Protector 2.30
Then unzip the archive in an empty folder on your hard disk (NOT the Unreal Tournament directory !) and click on the protector.UMOD file.

When the dialog box asks for asked the name of the install directory type the UT base directory, i.e. C:\UnrealTournament .

After a successful installation you should have the following new files on your system:

in C:\UnrealTournament\system
protector230.u (the executable code)
protector230.int (the mutator description)
protector230.ini (the configuration file)

in C:\Unrealtournament\help
protector230.txt

To uninstall protector just remove the above files

Admins: Protector does not require changes to config files.



Getting started
Start UT and begin a practice session or a multiplayer game. Select Protector and any other mutators that you want to use with it from the mutator list.
You will notice that freshly respawn players are translucent and can not be killed, nor they can frag other players. This is the respawn protection at work.
Protector installs a setup dialog under the Mod menu in the UT menu bar. You can access the menu to change the Protector settings. Moving the mouse over a slider or checkbox will make appear a help line at the bottom of the screen.

Protector is a server-side mutator, so it only works in multiplayer games if it is installed on the server.



Configuration Options
The protector.ini file contains variables that can be changed to control the mutator behaviour. To change the variables open the protector.ini files with Notepad or another text editor.

This is a sample protector.ini file: the notes in italics explain the meaning of the variables and must not be typed.

NOTE: Most of these variables can now be changed directly from the Protector option panel, under the Mod menu.

[Protector.Protector]
EnableRespawnProt=True enables respawn protection
ProtectTime=10 the time in seconds before respawn protection expires
ScaleGlowBy=2 the amount of translucency of protected players
ProtNoFrags=True protected players cannot frag other players
ProtectBots=True apply respawn protection to UT Bots
ProtectHumans=True apply respawn protection to human players
ProtFromCannon=True activate respawn protection from Assault cannons
DynamicProt=True Enable dynamic protection
pmsg1=You are under protection. this message is sent to a player just after respawn
pmsg2=You are no longer protected. this message is sent to a player when protection expires