//-----------------------------------------------------------------------------
// ProVote7  - Released Version 7.1 - May 2003
// By ProAsm - http://unrealza.co.za/proasm
//           - http://proasm.totalcoversions.com
//    email: - proasm@stormnet.co.za
//-----------------------------------------------------------------------------

Version 7.1
-----------
Added TotalPlayer where MaxPlayers and MaxSpectators cannot exceed TotalPlayers.

Server String = ?Mutator=ProVote71.ProVote71

Version 7.0
-----------
Identical to 6.0 except the Clan Password in the ini has been changed to
ClanGamePass

A new GamePass has been added for general gaming (not a clan match)
GenGamePass

If GenGamePass has a password then when a ClanMatch is not in process
this GamePassword will be used.

A ClanMatch will still use the ClanGamePass as always but then the new
GenGamePass will be ignored.

Version 6.0
-----------
Just a rename of 5.5

Version 5.5
-----------
Removed BurningPlayer - caused hassels
Removed Playerstats - caused some lag
Removed ProtectAllPlayers during voting.
Restored [ClanMatch] Display - kinda got dumped along the way :)
Disabled Voter protection - caused damage to be none sometimes.
Player Stats window displays all the time.
The game will now remove old ServerPackages= versions of ProVotexx
A Full or ClanAdmin can now pause the game at anytime.
Mutate ProVote pausegame
Second time un-pauses the game.
A Full or ClanAdmin can now add a Bot to the game
Mutate ProVote Addbot

Version 5.4 - got horribly corrupted
Version 5.3 - Lost in Hard drive crash

Version 5.2
-----------
Few extra requests added here.

Almost everything is now Menu driven.

Changes to Practice Session.
Here the Admin can now select how many Bots he wants on the Bot Team.
Should he want a one for one setup then set Bots = 0

Each Game now has its own settings for:
Number of Bots.
Max Number of Players.
FragLimit.

When a Player logs onto a server and the Number of Players are at a Maximum,
the logged on Player will automatically be made a Spectator.

A new variable added to the A1 Admin menu - Show Player Stats
If checked, at Game End an extra Tab will show marked "Stats"
This will show who had the most PowerUps, who had the most Headshots etc.
This Tab can be accessed by a Limited Admin anytime, even if its set to False.

Server Date/Time shifted to screen top and made Darkgreen.

Replaced AltScore with BurningPlayer from [ElBundee].

If a Game Password is set (ClanMatch) - Spectators are all Muted.

Players that were Muted can be "unmuted" by ProVote Admin:
Mutate ProVote UnMute PlayerName
NB... Messages only. Speech will remain disabled till next level.

Players IP Addresses can be displayed by Admin:
Mutate ProVote PlayerIDs

Version 5.1
-----------
Tournament Mode can now be set as a default.
Vote Window now opens if voting for Assault.
Player Mute Voting function added.
Anyone can now set the Bot Skills.
Mutate ProVote BotSkill x
x can be from 3 to 7

An option to display the Servers Date and Time in Scoreboards.
Various little bugs fixed.

Version 5.0
-----------
PLEASE NOTE:
The Admin logon has changed since 4.6

Before:
Mutate ProVote password

Now:
Mutate ProVoteAdmin password

MOTD - (Message of The Day)

Due to the requirements for a LARGE MOTD Line 1 logon it was necessary
for another version again :)

A MOTD Admin page has also been added where you can update the MOTD
a line at a time.

Whatever you put in the MOTD Line 1, will now be displayed in BIG
yellow writting to everyone that logs onto your server.

To enable the above make sure the "Enable ProVote MOTD Information"
checkbox is checked.

The ServerName can now also be changed from the A2 Admin Menu.
Remember for this name to be TRUE, the "Use ProVote ServerNames"
checkbox must be checked.

The Admin Menu has also changed slightly in that the now two Admin
Menus are called A1 and A2.

ForceRespawn added to the GameSetup Menu as a checkbox.

NB.. The Servers current ServerName and MOTD information is NOT sent
to the ClientAdmin and hence NOT displayed in the menu when he calls
it up as it is too much to replicate to the client during a game.
Normally should you want to edit this, first press F2 to get this
information then call up the ProVoteMenu.

The 1on1 and 2on2 added at the end of a ServerName has been removed.

Several bugs from 4.6 were also fixed.

Other changes.

Reduced maximum allowable Players for a TeamGame from 4 to 2.
If game is set for only 2 Players (1on1) ForceRespawn is enabled.

A Spectator can now login as Full Admin.
Mutate ProVoteAdmin password

The password being the ProVote ServerAdmin password for Spectator.

NB.. Login is not possible if a vote is in process by the players.

NB.. ClanLeader Spectators cannot login as Admin at this stage.

Also the Spectator Admin must take responsibility for his actions
as he is interfering with the game in process.

Once a Spectator has logged in as an Admin, he can no longer call
on the Spectator Menu which allows him to switch to a Player.
He needs to leave the game and come back.

Admins can now switch a Game without voting.

Version 4.5
-----------

As requested, when a new Game is selected the map voting window now
re-appears so you can select or vote for a map for the new game rather
than just always referring to a default map.
However, should a vote not be reached within 2 minutes, the default
map for that game will be used.

With further experiments on Spawn Protection this version now spawns
the player completely invisible for the prescribed time.
It is recommended the spawn protection time should not exceed 5 seconds.

Players can now cast two votes per level rather than one as before.

Version 4.4
-----------

Added Bot practice sessions for Clans.

In any Team based game, Players will always be one Color and Bots the other.
For every Player that enters the game a Bot will enter, the same goes
for when a Player leaves the Game a Bot will leave the Game, thus the
Player / Bot ratio is always the same. The Bot that leaves will be the
weakest of the current playing Bots.

Clan Admins.
In the Game Setup menu just check the "Practice Session" to activate
this function. Regardless of your Bot settings the game will be set for
0 Bots and added/subtracted as need be.

Admins can change the Highskill level from 5 to 7:

Mutate ProVote Botskill 6

Admins can select the HighSkill (Asskick) level from the Game Setup Menu.

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

NB..... The little 'x' after ProVote4 or 5 designates the current release.

VoteMenu = MUTATE PROVOTEMENU

This Votemenu is for both Players and Spectators.
The Spectator Menu has only limited functions.

Please Note:

The following maps must be in the maps folder for ProVote4x to
function correctly as it uses these maps when switching to a new Game.

DM-Morbias][
DM-Liandri
CTF-Face
DOM-Olden
AS-HiSpeed

Additions in ProVote4x.

Voting.
A change here is that lets say there are 3 players.
With ProVote3 someone makes a vote.
The next vote is NO and the Vote fails even though the 3rd Player did not vote.
With ProVote5x everyone has to vote or at timeout the votes are counted.

At game end with ProVote3 as many votes as possible are made and if they all
fail the server just switches to the next map in the maplist.

With ProVote4x there is an option the admin can set for how many votes can
be made (default 5) before ProVote4x anounces a "LastVote".
Everyone now makes a vote and when all votes are in, the map with the most
votes gets the vote.

//-----------------------------------------------------------------------------

Installation.

ProVote5x.ini

NB.. Almost everything in the ProVote5x.ini file can be set ingame by a
Full Admin or ServerAdmin.

There are 3 Passwords:

AdminPass=   (Limited Admin)
ClanPass=    (Clan Leader admin)
ServerPass=  (Full Admin)

These Admin functions will be explained later.

ServerIP=

If ProVote5x is used on a Server it is VERY important the IP address is added
here although it can be done ingame.
This is to enable Player to Spectator swopping.

ServerMuts=

If there is any additional Mutators you wish to permanently be used with your
Game, just add the name here, just make sure it does not clash with the Mutators
offered by ProVote5x in it's Game Menu.

//-----------------------------------------------------------------------------

Starting up ProVote5x. (x = subsiquent version)

In Singleplay just select the Mutators screen and select ProVote5x.

The best way to start ProVote5x on a server is make sure the ProVote5x.u file
is in the System folder. Login as Admin......

Adminlogin Password.

Admin ServerTravel DM-Morbias][?Mutator=ProVote5x.ProVote5x

ProVote5x when run for the first time will look in the INI file to see if the
ServerPackages=ProVote5x
is setup and if it is not it will automatically do so, as this is necessary
for multiplay games.

If you did not manually do the ServerPackages=ProVote4 and ProVote did it,
then it will be necessary to restart the server again with the above command.

The otherway is to add ProVote5x to your startup string.

ucc server dm-morbias][?game=Botpack.DeathMatchPlus?Mutator=ProVote5x.ProVote5x etc..

//-----------------------------------------------------------------------------

Admin Functions with ProVote5x

As explained earlier ProVote5x offers 3 Admin accesses.

Please Note: This applies to Singleplay games as well.

All Admin loose their Adminship when they die or a level changes.

All Admin login with the following.

MUTATE PROVOTEADMIN PASSWORD

1. The Limited Admin

This admin uses the password:

AdminPass=

This Admin does not have access to any of the Admin Windows for setting up
Game functions and is restriced to Game Play admin only.

The Limited Admin can switch settings etc. when alone on a server.
He/she can also kick a player during a game without having to vote for it.

2. The ClanLeader Admin

This admin uses the password:

ClanPass=

This Admin has all the above access as well as access to the GameSetup Window.
Here he/she can setup a Team Game to whatever is suited for the match,
including a Game Password etc.
NB.. the Checkbox [Set as Default Game] is only accessible by a Full Admin.

It will also be this Admins responsibility to set the game back to its original
state when the match is complete or he/she can just select "DefaultServerGame"

3. The Full Admin

This admin uses the password:

ServerPass=

This Admin has all the above access as well as the GameSetup in any game and
is not restriced to Team Games.

Check all the 3 Admin Windows for all the setups available.

A Note on the Admin1 Window.

These settings need some explaination as follows:

CheckBoxes:

Spawn Invis.
This will enable or disable the GreenGlow a Player has when he respawns during
Spawn Protection, if this is enabled.

Enable EndVote.
This enables Voting at game end and the Votemenu will automatically popup etc.

Use Server Names.
This enables or disables the set ServerNames that ProVote5x will display,
depending on what game is currently being played.

Show Spectators.
ProVote5x will display 8 Spectators in all the scoreboard on the top righthand
corner. This function can be disabled here.

Sliders:

Protection Time.
This is the amount of time a Player has Spawn Protection.

Vote Wait Time.
This is the amount of time that lapses at a game end before the VoteMenu pops up.

Game Vote Time.
This is the amount of time allowed at Game Start for Voting to take place.

Game End Time.
This is the amount of time a Server will wait for voting to take place before
it switches over to the next default map in it's maplist.

EndVote Count.
This is the number of Votes ProVote5x will allow at Game End before the Final Vote
is announced where everyone votes and the map with the most votes wins.

Buttons:

Clicking any of these buttons will display the current settings in the editbox.

ServerIP.
Type in your Server IP in the editbox and click the button ServerIP.
This will set ProVote5x up with the necessary IP - eg: 106.21.44.121

AdminPass.
Here a Full Admin has the option of viewing or changing all the passwords.

DefaultGame.
This is only a viewing function to see what the current default game is.

AcceptIP's.
Here an Admin can add or subtract IP prefixes as follows:
+196
This will add 196 to the list.
-54
This will remove this IP from the list if it exists.

Please note, only one at a time can be done.

If the CheckBox - AcceptIP's is Unchecked, then the Button will change to
"Ban IP's" and the IPLow and IPHigh will come into effect.
This is entered seperated by a period.
65.201
This will set the IPLow to 65 and the IPHigh to 201

Any Admin can logout if he/she wishes (sometime necessary) with:

MUTATE PROVOTEADMIN LOGOUT

ProAsm
