*************************************************************************

                              ProDuel3
                          Tournament DUEL
                          (c) ProAsm 2002
                        Release version 3.0
                       proasm@stormnet.co.za
                   http://www.unrealza.co.za/proasm
                A ServerSide Mod for UnrealTournament

*************************************************************************

New in version 3.0
------------------

Only 1 ini file now - ProDuel3.ini
Force respawn set in ini file
Shieldbelt set in ini file
Vials set ini ini file
Client Date/Time display in scoreboard
Removed IpPrefix Accepts - only ban now low.high

New in version 2.0
------------------

ProDuel can now work with a ListenServer.
The bug with the Start Message has been fixed.
Spectator to Player swopping has been improved.
Add PowerUps is now an option for the next player.
See the Ban/Accept IPs in the Admin Config Section.
Weaponstay and Powerups now displayed in ScoreBoard.
The number of Spectators can now be set between 2 and 12
ProDuel now 1st checks the Winners maps so that the
NextPlayer cannot select a map the Winner does not have.
Should there be only 2 players on the server and a winner has
won 3 times, that player now becomes the challenger again and gets
the map choice.

Installing ProDuel
------------------

The following files need to be in the UnrealTournament\System folder.

ProDuel3.u
ProDuel3.int
ProDuel3.ini

The ProDuel3.ini file
-----------------------

[ProDuel3.ProDuelCfg]
PDPass=wxyz
ServerIP=196.3.171.136
MaxSpecs=12
NumFrags=15
GameTime=10
bCheckMap=True

ServerIP
--------
It is IMPERATIVE that the Server IP Address be put in here, although it
is possible to do it ingame from the Admin Window (see later)
Without this address Player to Spectator swopping is not possible,
and the game will not function correctly.
NB. Do NOT add the port address - ONLY the IP address.
For example:
123.45.67.89

MaxSpecs
-------
Here you can set the total number of spectators allowed.
This can also be set within the Admin Window.

NumFrags
--------
This will be the FragLimit set in the game.

GameTime
--------
The Game TimeLimit.

bCheckMap
---------
If set to True, the Winners maps will be checked before the Challenger
gets his Mapchoice. Setting this to False, disables this function.

PDPass
----------
This needs to be added after certain Mutate command access like:
Mutate PDMaps wxyz - or whatever password the admin selects.

NB. All this must be set from the Admin Window ingame.

--------------------------------------------------------------------------------

Once the server starts up you need to do the following to get the Game working.

Either access the server though the WebAccess and select Tournament DUEL as
the Game, or logon to the game as an Admin.

AdminLogin password.

Then is the Console type in the following:

Admin Servertravel Dm-Morpheus?Game=ProDuel3.ProDuel3

Should your server often need restarting for whatever reason it may be an idea
to start the server with the game ProDuel as follows:

UCC.exe server DM-Morpheus?Game=ProDuel3.ProDuel3 ini=server1.ini log=server1.log

This is assuming your server ini file is called server1.ini

NB. ProDuel3 does not require and alterations with the INI files.

--------------------------------------------------------------------------------

Game Information
----------------

Playing the Game
----------------

A player can logon on as a player or a spectator although it is best that everyone
logs as a Player and not a Spectator, and once in the Game, swop with a Spectator
if you do not want to play immediatley. The reason for this is should you log on
as a Spectator, then move up the ranks to become the next Player, it is sometimes
possible that you will get a "Connection Failed" from the server.

The 1st two players to logon will be accepted as the players.
Any further players logging on (up two 12) will automatically become Spectators.
These Spectators will be listed in order of logon and displayed with their ping
status marked green in the scoreboard. The Top Spectator who will be marked Red
will be the next player who plays the Winner of the current game.

When the current game ends, the top Red Spectator will recieve a Map Selection
window from which he/she can select a map to play the current Winner.
This Spectator also has the choice of setting WeaponStay on, or as from version
2.0, Powerups on, as these are defaulted off at the end of each level.
At this point the Top Red Spectator will become the second Player (Challenger)
and the looser of the current game will become a Spectator and slot in at the
bottom of the list.

Should a Player leave or quit the game, that player will temporarily be disqualified,
and not allowed back in for the first 30 seconds at game start.

Spectator Options
-----------------

By bringing down the Console and typing the command:

Mutate PDMenu

A Spectator or Player will receive a popup window with various options.

Bind PDMenu
-----------

A key can be bound to save type the command each time.


SpecToPlayer
------------

This option will only be available if a Player is missing after a period.
A Spectator can then become the missing Player. This is normally when only
a Spectator and one player are left in the game.

BehindView
----------

This enables a Spectator to view the Player in a Players perspective view.


Submit Swop
-----------

Here a Spectator can request to swop places in the list with another Spectator.
The Specator can also type in a short reason for wanting to make the swop.
The requested Spectator will receive a popup Window giving him/her the option
of either accepting or rejecting the swop. The sequence will then be resorted.

Player Options
--------------

Any Player has the Option of requesting a swop with a Spectator.
NB.. A Spectator cannot request a swop with a Player.

Players also have the option in the PDMenu to Mute the Spectators.
This will disable any Spectator chatting to the Players.

Players will start the game as in any normal Tournament game.
Players also have the option of Muting the Spectators so that
their chatting does not interfere with their game.
Spectator Muting is reset at the end of each game for comments.

When the current game ends, the Top Red Spectator will receive a popup
window requesting him/her to select a map to play the Winner.
Here he/she has the option of adding WeaponStay and or Powerups to the
map selection.
Should this window be closed for whatever reason, it will popup again
after 15 seconds until a map is selected. Should no map be selected
after 2 minutes, the next map in the server maplist will be chosen and
the server will switch accordingly.

Next Game
---------

Once the Top Spectator has selected a map, the sequence will be
setup for the next game, the order saved and the level will change.

NB.. if there are no Spectators, the looser will get the map option.

--------------------------------------------------------------------------------

Admin Options
-------------

To bring up the Admin window by the Admin - in the Console:

Mutate PDMaps password
----------------------
This will bring up the map selection window.
When the Admin receives the popup he/she will be given the option
to remove any map (up to 50 maps) in the map list.
When the level restarts these maps will then not be shown in the list.

The Admin Window
----------------

Only the Admin will see this window which offers the following.

Reset
-----
This will clear all Spectator and Player sequences and restart game.

Restart
-------
This will save all player positions and restart the current level.

The information below needs to be entered into the EditBox.
-----------------------------------------------------------

Kick Nickname
-------------
This will kick a Player or Spectator out the game.

Restore Map
-----------
Restore a previous rejected map from the MapList .

FragTimeLimit xx.xx
-------------
This sets the game Frag and Time Limits for the game.
eg. If you require a FragLimit of 15 and a TimeLimit of 10 minutes,
you would enter it as 15.10

MapChecking
-----------
Entering a On or a Off in the editbox will Enable or Disbale the
Winner getting his maps checked before the challenger selects a map.

Ban IPs
-------
This setting needs some explanation as the input is critical.
To only accept Ip's say between 50 and 120
Eg.. 50.120
This setting will reject all player IP addresses starting below 50
and above 120. For instance should a player try and logon with an IP
address of say 24.120.3.66 he will be Rejected by Server as his
IP Prefix (24) is below 50. The same goes for someone with an IP
address of say 194.3.56.221 as in this case his IP Prefix is above 120
The game is defaulted to 1.255 and can be changed to anything,
but great care needs to be taken here as you can well imagine.

Server IP
---------
This sets the server IP address in the format 12.34.56
NB. Do NOT enter the port number, ie.. :7777
Without the ServerIP, Player to Spectator swopping is not possible.

NB. All the above options require a level restart.

--------------------------------------------------------------------------------

Recap on Console Mutate Commands
--------------------------------

Mutate PDMenu - Brings up the main ProDuel Menu.

Mutate PDMaps password - Admin use only. Requires password

Mutate PDIP   - This will display the servers set IP.

