Limit By Ping. Version 0.1
============================

The Limit By Ping ut2003 mutator was developed by OzForces Internet (http://www.ozforces.com)

It's primary use it to restrict access to your dedicated ut2003 server based on the client
ping. This can be useful for creating "Dial-up only servers", servers restricted to the
users who only access the internet by modem. Equally it can be used to create Low Ping
only servers.

NOTE: If you are logged in as an Admin (adminlogin) the mut will not kick you because Admins are god :)

Basic installation
------------------
Unzip contents into the your system folder.
Copy the config section into your UT2003.ini or server.ini file.

Dedicated server install
------------------------
Install the .u and .int to your System folder, add the [OzForcesPak.MutLimitByPing] section to your ini.
To invoke the mutator via the web admin as normal. It is also wise to add the mut as 
a serverpackage (although it will work without it) by  adding this under the other serverpackages:
Serverpackage=OzForcesPak

If you want to start the mutator from the command line add:
?mutator=OzForcesPak.MutLimitByPing
after any other Muts or ?game= settings.

The mut will write a line to the console every time it checks (default 5 secs) if you want it print out less set 
the checkinterval higher.

Configuration
-------------
Controlling the mutator is through the ut2003.ini file or your dedicated server ini file. The 
first thing is to add the section:

[OzForcesPak.MutLimitByPing]
MinimumPing=100
MaximumPing=500
MaxViolations=4
WarningLevel=0
CheckInterval=5.000000
ClientWarning=This is Dial up ONLY server, your ping is too low you will be kicked shortly

Within that section you have 6 configurable options:

MinimumPing
The MinimumPing is the minimum allowable ping. Anyone who gets lower than this setting will be
removed from the server.

MaximumPing
The MaximumPing is the maximum allowable ping. Anyone who gets higher than this setting will be
removed from the server.

CheckInterval
The CheckInterval is a time in seconds. It controls how frequently each players ping is checked.

MaxViolations
The MaxViolations setting is used to give the client some leeway. This number determines how many
times the client can violate the ping requirements before being removed from the server.

WarningLevel
The WarningLevel is the number of times the client can violate the ping requirements before a
warning message gets sent to the client.

ClientWarning
The ClientWarning setting is the warning message that gets sent to the client when they start
violating the ping requirements.

The following is an example ini configuration. Each client is allowed to have a ping between 100
and 500. The client can violate those parameters 4 times before being removed. As the WarningLevel
is 0 the ClientWarning will be sent to the client 4 times.

[OzForcesPak.MutLimitByPing]
MinimumPing=100
MaximumPing=500
MaxViolations=4
WarningLevel=0
CheckInterval=5.000000
ClientWarning=This is LimitByPing server, your ping is too low/high you will be removed shortly


This mutator was written by Leigh Makewell ( leigh@ozforces.com ) and based on the HPBonly 
Unreal Tournament mutator written by "Major Disaster". Any questions should be sent
to Leigh Makewell.
