Protector Mutator for UT

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

Version: 2.00
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    
Voting system commands    
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 mutator makes all players and bots invulnerable for some seconds after respawn, in order to discourage respawn campers.
It also has a voting system that allows players to kick somebody out of the server.



New features in this version
Added a voting system to kick lamers out
Both voting and respawn protection are optional
Vast performance improvements:
- does not create or spawn objects.
- fast table lookup.
- one lightweight process manages all players.



Installation
If you have a pre 1.00 version of Protector you should remove the following files before installing the UMOD version:
from c:\unrealtournament\system :
protector.u
protector.int
protector.ini

from c:\unrealtournament\help :
protector.txt

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
protector.u (the executable code)
protector.int (the mutator description)
protector.ini (the configuration file)

in C:\Unrealtournament\help
protector.txt

To uninstall protector just remove the above 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.



Voting system
It is possible to start a vote to kick out of the server a player who misbehaves or annoys other people.
To start the vote open the console and type (case and spaces between word do not matter)

MUTATE VOTE KICK playername

You have just started a vote, and other players may join typing :

MUTATE OK

from the console. After an interval (the default is 30 seconds) the voting ends and the result is checked. If the OK votes are the majority the disturber is kicked. Notes:




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.

[Protector.Protector]
EnableRespawnProt=True enables respawn protection
ProtectTime=7 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
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
EnableVoting=TrueEnables the voting system
votingInterval=30How long should a voting session last
maxVotings=3 Players cannot start more than 3 voting sessions.