Installation

NB. Dont forget in the UT2004.ini file to add...

[Engine.GameEngine]
ServerPackages=UT2Vote57

The following files need to go in the UT2004 System folder:

UT2Vote57.u
UT2Vote57.int
UT2Vote57.ucl
UT2Vote57.ini
UT2Vote57.ini.lix - (for Linux only)

UT2Vote57 needs to be added as the only Mutator in your Server startup commandline as UT2Vote handles all the mutators once it is loaded, so its best to not have any commands in start up except multihome if needed or specifying ini= or as some server companys insist maxplayers= as UT2Vote takes over the command options.

Single Server
ucc server CTF-Maul?Game=xGame.xCTFGame?Mutator=UT2Vote57.UT2VoteX etc..

Multi Servers
ucc server CTF-Maul?Game=xGame.xCTFGame?Mutator=UT2Vote57.UT2VoteXMulti etc..

The Multiserver system will create new configs in the Server.ini file or the configs can be copied and pasted from the UT2VoteXMulti.txt file.

You also need to add UT2Vote57 as a Serverpackage in the servers UT2004.ini file although UT2Vote57 will add itself now if it cannot find itself in the Serverpackages.

[Engine.GameEngine]
ServerPackages=UT2Vote57


Brief Setup

UT2Vote requires this information to be entered at the following places:

ServerMuts=
Mutators that will be common to ALL games must go in here.
These mutators will apply to ALL games ALL the time EXCEPT in a ClanMatch.
Basically the Mutators that you would normal add in the Startup commandline, should now go here
For example:
ServerMuts=ServerBots2.ServerBots,UnrealGame.MutLowGrav,XGame.MutNoAdrenaline
Note: A Mutators ClassName can be found in the .ucl file supplied with the mutator.
Should you require the Mutators to be more flexible, it would be better to add them in the Mutators= section in the GameType= strings instead of here.

ServerLine=
Any commandline commands that you need for all games should go here, for example:
ServerLine=?AdminName=Admin?AdminPassword=xxxxx?Translocator=True
Any commands entered here will take priority and over ride the GameType Commands=
Like the ServerMuts, these commands will apply to ALL games ALL of the time EXCEPT during a ClanMatch.

VoteAdminPass=
This is the Main Admin password and will give this Admin full rights to accessing anything in UT2Vote.
ClanAdminPass=
This password is for Clan Leaders who can setup the server for a dedicated ClanMatch.
This Admin will not have access to the general Admin settings of the server.

GamePassword=
If the Games on your server requires ALL players to logon with a Game Password, that password should be entered here.

DefaultGameName=
Whatever you choose to be your Server DefaultGame needs to be entered here.
If you leave it blank, UT2Vote will enter the game from which your Server first starts up in.

Example:
DefaultGameName=Capture the Flag

When players have all left your server and it is not in a default state, UT2Vote will switch your server to this Default Game State.
When UT2Vote first starts when your server starts, this game and its DefaultMap will be loaded.

DefServername=
Enter the name of your server here. Although UT2Vote can change this ingame, should there be an error, it will default back to this name.

You are now ready to startup your Server.

Once your server is running, join the Game and login as Admin:

Mutate UT2VoteLogin (the VoteAdminPass)
Press the Map Menu Hotkey (normally set on the ScrolLock and/or Home Key) and once the menu is up, click on the Admin button and you will start seeing the world at your fingertips.

NB.. Almost all Admin changes will need a level restart.

Back to Top










The UT2Vote57.ini file

Ini file information and configurations

Select a Setting Header

UT2VoteConfigs
UT2VoteInternal
UT2VoteVoting
UT2VoteIniOnly
UT2VoteGameTypes
UT2VoteMutators
UT2VotePackages
UT2VoteMapCheck
UT2VoteGameSwitch
UT2VoteNewMaps
UT2VoteKickBan
UT2VoteMapInfo
UT2VoteMapsVoted
UT2VoteClanSetup
UT2VoteMessages

Back to Top













[UT2Vote57.UT2VoteConfigs]

VoteAdminPass=
This password will give this Admin the same powers as the ServerAdmin.
In other words he/she will have access to anything and everything at any time and can login in with:
Mutate UT2VoteLogin password

Please Note... all the following settings are available ingame in the Admin Menu

ClanAdminPass=
This password will give this Admin the powers to only setup a game for a Clan Match.
Here he will be able to select the GameSetup Menu and do the necessary configurations for a match - again:
Mutate UT2VoteLogin password

NB.. Admin no longer loose there Adminship when they die.
Logging out as Admin
Mutate UT2VoteLogout

GamePassword=
This password is the general Game Password which all players will need to logon onto your Server.
As there was much confusion in version 1.6 about this password it was decided to have a special dedicated place for it.

DefaultGameName=
This is the friendly name you want your server to be as the default game and UT2Vote will set this up for you.
Whatever game you are running the very first time you start UT2Vote it will use that name as your default.
Basically now what happens and provided that DefaultSwitch=3 is every 3 minutes UT2Vote checks your server to see how it differs from the default.
If there are no players on the server and a voted mutator is running and its not the default game,
it will switch your server back to the default game and remove all voted Mutators and Arenas etc.
When the server switches back to DefaultGame automatically, it will always switch to its Default Map
which is setup in its appropriate GameType - see Game Configurations.
When UT2Vote first starts when your server starts, this game and its DefaultMap will be loaded.

DefServerName=
Here you enter a default name for your Server.
Sometimes with Clans changing the server name or a game with a servername that may have an illegal character in it, UT2Vote will then revert back to the DefServerName.

ServerMuts=
Mutators that will be common to all games should go in here.
If you have more than 1 Mutator, seperate them with a comma.
Please note also that the ServerMuts must only have Mutators in it.
If you have extra commandline parameters they must go in the ServerLine= - see next item.

ServerLine=
All commandline paramaters (ie. ?AdminPassword=Whatever) that are common to all games must go here.
Any command you have here will over ride a Game command as the ServerLine has higher priority.
Every command parameter must start with a ? (question mark).

bAllowMuts=
bAllowArena=
bAllowGames=
bAllowKick=

Setting these to True or False specifies whether they can be votable or not. Defaulted as True.

bNoVotePopup=
Defaulted to False, but setting it to True will disable the MapVoteMenu poping up at Game End and instead it will just momentarily display a < Mutate UT2VoteMenu to Vote > for the players information.

bDoGamePopup=
Defaulted to False, but setting it to True will force the Map Menu window to popup anytime during a game when someone decides to make a vote. Having this set to True can be very annoying to the game, but some prefer it that way :)

bShowBotsKick
If set to True the Bots will appear in the Kick Menu and can be voted out the game.

bAllowBehind=
When set to True it will allow Players to use 3rd person viewing in the games. BehindView 1

bNoRestart=
If set to True, players will not be able to vote for a Restart at Game end.

bWebAdmin=
If set to True, then then all Mutators and non UT2Vote Games will not be seen in WebAdmin.
This is a safegaurd against Mutator clashing but should only be set to True if UT2Vote57.UT2VoteX
is set in the server startup commandline.

bHideNames=
If set to True, then when a player makes a kickvote his nickname will remain anonymous and so will the players that voted Yes.

bAltSwitch=
With the many mutators now available and adding them all to the commandline sometimes causes UT2004 to lockup duting level changes. This function will eliminate this problem

bCheckClient (was bCheckMaps in IniOnly)
If set to True, this will look through a players maplist to see if he has all the server maps.
Those maps he does not have will not be displayed in his Map List.

bMutAlone=
Will allow a single player on your server to switch Mutators

bArenaAlone=
Will allow a single player on your server to switch Arenas

bVoteWhenDead=
If set to True, then players can vote before the Game starts and while they are dead.

bAlwaysKick=
During the Game and once the Voting timelimit has expired and the play calls for the normal VoteMenu, the KickVote menu will pop up instead.

bDisDemoRec=
This will disable UT3Vote Admins from starting a Demo recording.

bColorSkins=
A DeathMatch game will use team color skins.

bDisAllVoting
If this is set to True then Players will not be able to vote anything.
Only Admins will have access.

bDisServAdmin=False
If set to True, the ServerAdmin will not be allowed to configure UT2Vote menus.

bDisOpinion=False
If set to True, the map Opinion button will be disabled in the Map Menu.

bDisAdminMesg=False
If set to True, the Admin Message button will be disabled in the Map Menu.

bClanServName
If set to False, then Clans cannot change the Servername in the Setup Menu.

bUseChatLog=
When set to True, all player typed messages will appear in server log file
The format being:
UT2Vote_ChatLog: Date:Time - Nickname - Message

bUseChatMap
If set to True, then the ChatLogs will be appended to MapNames rather than one big log.

bUseChatIDs=
Will allows the players Unique ID to be logged in the Chatlog

bUseChatIcons=True
This will enable a UT2Vote chaticon.

DefaultSwitch
This is the time in minutes that the server checks whether there are any players on the server and if not, switches to the Default Game and also if bSwitchDefMap=True to switch to the Default Map.
If DefaultSwitch=0 then this option will be disabled.

bSwitchDefMap
If set to True, then after a time period as set DefaultSwitch= if there is no players on a server it will switch to the DefaultMap.

bSwitchRndMap
If set to True, a time period as set DefaultSwitch= if there is no players on a server it will switch to the Random Map as set in the ini file under [UT2Vote57.UT2VoteRandomMaps]
Up to a maximum of 30 maps per gametype can be set for a Random map pick.
NB.. for this option to work, the above must be bSwitchDefMap=False as it takes priority.
It should also be noted that the random map chosen when a vote fails is also taken from here.
Should no Random Maps be set in the ini file, the first 30 maps from the Game MapList will be used.
bUseUniqueID
If set to False, then UT2Vote will track players by their normal Player IDs rather than their CD-Key IDs
This is usefull for LAN games where several players use the same CD-Key.

MesgTypeTime=
Many players have complained on how the popup menu interrupts their Say messages at the end of the Game.
Basically what happens now is UT2Vote will first look to see that everyone has finished typing their messages before poping up the VoteMenu. In other words if anyone is typing a message when its time to popup the Menu, UT2Vote will send that person a message:
**** Finish your message - Voting Time ****
UT2Vote will now wait another 10 seconds before it checks again.
Everytime it checks for someone typing it will also check the TypeTime you set above and if this TypeTime has expired, the VoteMenu will popup regardless of who is still typing and send those people a message:
**** Sorry - Time Up ****

MaxPlayersIsp=32
The number represented here is the Maximum number of Players and ISP will allow for any Game.
For those that do not have a server through an ISP just leave it as 32


Back to Headers






[UT2Vote57.UT2Internal]

Note:
All parameters here are for UT2Votes internal usage and should not be altered in any way.

bArena=False
bArenaAST=False
bArenaBIO=False
bArenaFLK=False
bArenaLNK=False
bArenaMIN=False
bArenaRED=False
bArenaROC=False
bArenaSHK=False
bArenaLIT=False
bArenaAVR=False
bArenaGRN=False
bArenaMLY=False
bArenaSNP=False
LevelChange=False
TimedGame=
VotedGame=
LimitGame=
SemiPass=
Nounce=0


Back to Headers







[UT2Vote57.UT2VoteVoting]

VoteChangeNum=3
The option bChangeVote has been dumped in favour of VoteChangeNum and if set to 0 will disable vote changes.
The number of Changed Votes is now configurable in the AdminMenu up to a maximum of 99.
The number of vote changes is now displayed in the map menu after a player makes his/her first vote.

VoteMinTime=30
The total amount of time allowed before Voting timeout for 2 Players.

VoteMaxTime=120
The maximum Voting time allowed regardless how many players are on the server.

VoteStepTime=7
The additional time allowed for every Player that joins the Server after the VoteMinTime.

VoteIdleTime=15
After everyone has Voted, this is idle time waited for someone to change there vote.
If no further votes are made the VoteMaxTime will be forced and the vote will be decided.
If however someone makes a vote a further Idle Time will be set.

GameVoteLimit
The number of votes a player can make during a game.

GameVoteTime=
This is the time in minutes allowed from the START of a game that players can call a vote.

VotePercent=
This is the accepted percentage to pass a vote ONLY during game voting.

MenuPopupTime=0
This has been added to the Config section and if greater than 0 it will control the time it takes for the Menu to popup when the Game ends.


Back to Headers






[UT2Vote57.UT2VoteIniOnly]

NB.. The following settings are Ini file settings only and fall under the heading:

NewMapButnText=
This is for Admin option to change the text on the NewMaps button
The information in the [UT2Vote57.UT2VoteNewMaps] can then be tailored for other purposes.
NewMapMenuText=
When the NewMaps button above is clicked, this information will display on the menu heading

bStandardServer=True
This will enable your server to be displayed as a Standard Server

bDisplayRec
If set to True it will display when a Demo recording starts.

bSortOpinion
If set to True, this will display the Voted maps in Opinion order rather than Voted order.

bDisMapCon
If set to True, then when a Map Menu is called, the clients Console will not be cancelled.

bNoClientWarn
If set to True, Players will not receive a warning notice when logging onto UT2Vote the first time and their client settings have not been done.

bNoPlayerMute=False
This will disable muting of players by the VoteAdmin.

BanMinLevs=
The minimum amount of levels players can be kick banned for.

BanMaxLevs=
The mmaximum amount of levels players can be kick banned for.

bDetectUTComp=False
If set to True, then some things will be disabled in UT2Vote.

bMapChecks (used to be bMinMaxMaps)
If this is set to True then the game will check to see if the selected map is suitable for the current number of players as defined.
As from 5.5 the GoalScore and/or the TimeLimit for any given map can also be changed.
Should any of the options =0 it will be ignored and the server default used.
[UT2Vote57.UT2VoteMapCheck]
CheckMap=(MapName="DM-Smallmap",MinPlayers=0,MaxPlayers=4,GoalScore=10,TimeLimit=10)
CheckMap=(MapName="CTF-Hugemap",MinPlayers=10,MaxPlayers=32,GoalScore=30,TimeLimit=20)

NB. Only maps using the currrent games MapPrefix= will be used and all AltMapPrefix= ignored.

bMapCheckSpecs=False
When using the [UT2Vote57.UT2VoteMapCheck] and this is True, Spectators will be added to the MaxPlayer count.

bUseRandomMap=False
If set to True, then when a vote times out and the vote fails, UT2Vote will choose a Random map from the Server maps folder or List instead of the Default map.

bGameRepeatLimit=False
If set to True, the Games will only be votable every alternate Game voted.

MapListSort=0
0 = Alphabetical A - Z listings.
1 = Alphabetical Z - A listings.
2 = Random selection on each level.
3 = As in list - best if UseMapList=True


bNoCenterMessage=False
When set to True, Players will not receive UT2Vote message in the center of the screen during a game.
This was added as players complained the message hid the crosshair.

bSpectatorSpy=True
this allows players to set their ClientMenu options so as to be notified if a Spectator is viewing them.


Back to Headers







[UT2Vote57.UT2VotePackages]
Packages=(MutClassName="Whatever.MutWhatever",ServerPackages="Whatever,Whatnext")

Mutators that are votable or that you have added to various GameTypes can be placed here.
Mutators will now only be pushed to the client when the Mutator is selected or voted for.
This saves each client having to download a multitude of mutators everytime they join your Server.
A Mutator can also have several ServerPackages and they can just be added to the above ServerPackages= and must be seperated with a comma.
All Mutators that appear in the ServerMuts= MUST be declared in the UT2004.ini ServerPackages=


Back to Headers







[UT2Vote57.UT2VoteMapCheck]
If bMapChecks=True then the game will check to see if the selected map is suitable for the current number of players as defined.
As from 5.5 the GoalScore and/or the TimeLimit for any given map can also be changed.
Should any of the options =0 it will be ignored and the server default used.
[UT2Vote57.UT2VoteMapCheck]
CheckMap=(MapName="DM-Smallmap",MinPlayers=0,MaxPlayers=4,GoalScore=10,TimeLimit=10)
CheckMap=(MapName="CTF-Hugemap",MinPlayers=10,MaxPlayers=32,GoalScore=30,TimeLimit=20)

NB. Only maps using the currrent games MapPrefix= will be used and all AltMapPrefix= ignored.


Back to Headers







[UT2Vote57.UT2VoteGameSwitch]
SwitchToGame=(SwitchHour=12,GameName="DeathMatch",ClassName="",DoSwitch=True)
SwitchToGame=(SwitchHour=15,GameName="Capture the Flag",ClassName="",DoSwitch=True)


At 12:00 if DoSwitch=True then DeathMatch will become your DefaultGameName and the server will switch to it 3 minutes later if there are no players on the server.
The same will happen with xCTFGame at 15:00
You can have up to 16 GameSwitches per day.


Back to Headers







[UT2Vote57.UT2VoteNewMaps]
NewMap=(MapName="DM-Whatever")
Admin can add mapnames here which will display in the NewMaps Menu.
Normally only the latest maps on the server should go here.
NB... Make sure the spelling is correct as these maps are voteable by players.


Back to Headers







[UT2Vote57.UT2VoteKickBan]
BanPlayer=(NickName="Whatever",UniqueID="4230fdb7a6cafda49fed3f4200fa97cc",IPaddrs="123.123.123.123",Levels=5)
This section is used internally and stores all the information from Players that have been kicked off, or voted off your server.
The only time you will set anything manually here is if you want to ban someone on a permanent basis by setting Levels=111

Back to Headers







[UT2Vote57.UT2VoteMapInfo]
This is used internally by UT2Vote

Back to Headers







[UT2Vote57.UT2VoteMapsVoted]
This is used internally by UT2Vote

Back to Headers















UT2Vote57
[UT2Vote57.ClanSetup]

This section basically explains what a ClanLeader needs to do to setup a ClanMatch.

Setup
The Setup Menu can now be used regardless what Game is currently being played.

Voting
Voting for Clan Matches has been removed completely as its basically never used and with the new Majority vote system does not work too well for Clans.

ClanPassword
If the ClanPassword is now omitted, the GamePassword will be used if there is one.

Games
Up to 3 Games can now be pre-setup for a Clan match.

Overtime
There is now an option which will end a Game if the Teams have Tied.

Server Name
Clan Admin have the option of setting a custom Server Name for the match.
However there is a bClanServName=True in the IniOnly section and if set to False the Server Name option will be disabled and the normal -[ClanMatch] added to the current Servername.
NB.. The Server Name option will only work if a Password is set.

Clan Names
Clans can now enter their Clan Names and these will be displayed for the screenshot at the end of the match instead of the normal Blue Team and Red Team.

Mutators
Clan Admin now have the option to add Mutators to their matches for each seperate Game played.

Client Menu
Except during a Warmup, Clans will have access to the Client Menu if the Map Menu is called.

DeathMatch
When a Game starts UT2Vote will check if its a Clan Match and if it is, it will check if its a Team Type Game and not a DeathMatch Game, and if its a DeathMatch Game, the game will Abort with a message and go onto the next Game or reset the Game back to its default state.
This now also a Clan=False option in the GameType string so that ClanAdmin cannot see a DeathMatch type game in the Clan Setup

End Map
When this button is clicked by the Clan Admin, the current map will be canceled, all scores cancelled and the match will switch to the next map if there is one, end the match or else reset back to default.

Start Match
The ClanMatch gets started.
Before this button is used, all settings must be saved with Submit Game Info!

Set Match
The ClanMatch gets prepared.
It will start after the current map has ended.
Before this button is used, all settings must be saved with Submit Game Info!

ClearAll
If no clanmatch is running, this will clear the actual setup.
This button becomes the EndMatch-Button as soon as a match is in progress.

End Match
As before - this will end the Match and reset the game back to its default state.

Swap Teams
Should Teams wish to swop colors for a particular Map, it has to be done with this button else the scoring system will loose track and award the wrong points to the wrong Team. Teams will swap instantly with this button.

Warmup Display
This will now permanently be displayed during a Warmup regardless whether in Hud or ScoreBoard and also ONLY during a Clan Warmup will the ScrollLock key be Hardwired for a Ready State and the display will be:
<< Warmup Period - Press ScrollLock when Ready >>
Players can ofcourse still use their Home or whatever key is bound to UT2VoteMenu.

Clan Save Default Setup

This is an option for the Admin to save the complete Clan Setup as a Default for future games.
This can then call the last Setup with the Load Default Setup button.

Back to Headers

Back to Top










UT2Vote57
UT2Vote Server Messages

[UT2Vote57.UT2VoteMessages]

Interval=20
The interval in seconds between each displayed message.
Duration=10
The duration in seconds of each message.
bFading=True
Whether the message should fade out during its Duration time.
bVoting=False
Whether messages should be displayed during a voting session.
bGameEnd=True
Whether messages should be displayed at Game end.
The Message setup: (1 line)

MesgInfo=(Enabled=True,GameName="All",Center=False,YPos=10,TextSize=3,TextColor="200.200.200.255",
                  Message="** Powered by UT2Vote **")


Enabled
If this is false the message will not be displayed.
GameName
"All" will display this message in all Gametypes, whereas should you wish the message only to be display in a certain came, like CTF, then set this as GameName="Capture the Flag".
NB... The GameName must be identical to the GameName= in the GameType= string.
Center
If this is True then the message will be displayed in the screen center.
YPos
This is the vertical position in a percentage from the top to the bottom of the screen to where the message should be displayed.
75 is the default, placing them directly above the chat messages.
TextSize
This is the size of the text for the message from 1 to 5.
TextColor
This is the color of the message text and needs to be the following format:
200.200.200.255 where its in the form of Red.Green.Blue.Brightness
A Color Chart
button has also been added in the ServerMessage Menu for Admin to select an actual color name.
This is for those that do not have a good understanding or how colors are made up.

See more Color settings.

Message
The actual message to be displayed.
NB... All messages can be added, removed or edited in the Server Messages Menu.
The button for this Menu can be found in the Admin Menu.
NB.. Maximum message length is 60 characters.

Back to Top








UT2Vote57
Clientside configuration settings

In the User.ini file you will see the followingand are all available in the ClientMenu

[UT2Vote57.UT2VoteClient]
bDefineSetup=True
bNoWeaponNames=True
bEndScoreBoard=False
bShowSpectators=True
bEndGameShot=False
bNoAnnouncer=False
bDisableHomeKey=False
bDisplayTime=False
bAnnounceHoly=False
AnnouncerType=2

bDefineSetup=
This is not user configurable and is used internally.

bNoWeaponNames=
This is already available by UT2004 but needs adding for it to function.
This just basically forces the issue a bit.
When the player switches between weapons the big colored nametag wont appear.

bEndScoreBoard=
When this is set to True, the game end ScoreBoard will be forced onto your screen.

bShowSpectators=
When this is set to True, up to 8 Spectators will be displayed in the ScoreBoard.

bEndGameShot=
If set to True, an endgame Screenshot will be taken.

bNoAnnouncer=
When this is set to True, all countdown Announcers will be disabled.

bDisableHomeKey
When this is set to True, the Homekey hotkey will be disabled.

bDisplayTime=
If True, this will display the local time in the Hud near the bottom.

bAnnounceHoly=
When this is set to True, the announcer will say HolySh*t after voting count down.

AnnouncerType=
Can select up to 6 Announcers.



Other Client Options

VoteMenu KeyBind
Click this button to set a keybind for activating UT2VoteMenu on any key you wish.

ClanReady KeyBind
Click this button to set a keybind for activating Ready at the end of a Clan Warmup.

Spectator Mode
Click this button to switch to spectator mode.

Demo
Click this button to start a Clientside Demo of the current game.

Back to Headers

















UT2Vote57
Adding extra Games

Adding extra Games

[UT2Vote57.UT2VoteGameTypes]

bSortGameList=False
This will sort the ini files GameList alphabetically.

Here every game, whether default or custom will be setup all in one line and can be individually configured.
Actually only the initial creation needs to be done here and the rest can be done with the ingame AdminMenu.
When creating another Game entry, just copy and paste any one of them then go and change the necessary configurations.
There are a few that need to be done in the UT2Vote57.ini file before you setup the rest in the AdminMenu, although you can do the whole lot here if you so wish.

UT2Vote Game Rules
  • The supplied default games cannot be removed.
        You can add games (up to 50) but cannot remove the default games.
        UT2Vote needs these default GameTypes for its reference.

    Here I will give an example of how to create a new Game and go through each setting in detail.
    A typical GameType configuration looks like this: (all in one line)

    GameType=(GameName="Capture the Flag",HideVote=False,Clan=True,RequiredPlayers=2,
                            MapLimits=0,ServerName="None",UseMapList=False,DefaultMap="CTF-Chrome",
                            MapPrefix="CTF",AltMapPrefix="",GameClass="XGame.xCTFGame",Mutators="None",
                            Commands="?GoalScore=5?TimeLimit=20?MinPlayers=2?MaxPlayers=17?MaxSpectators=2
                            ?Translocator=True?Weaponstay=True?BalanceTeams=True?ForceRespawn=False
                            ?PlayersMustBeReady=False?Difficulty=5?GameStats=False?GameSpeed=1.00?FF=0?NumBots=3")


    So lets say we have just copied and pasted that line and want to change it to DeathBall.

  • GameName=""

    This is one of the most important entries you make as a lot depends on the GameName.
    The actual length of the GameName depends on how many games you can fit into UT2Vote... let me explain.
    The way in which UT2Vote sends the information to the client is different to most.
    UT2Vote can send a maximum of 440 characters to the Clients GameMenu so....
    Lets take a name like "Capture the Flag" which has 16 characters.
    So if all the games had 16 characters that would be 440 / (16 + 1) the + 1 is the comma that seperates each game.
    This means UT2Vote can handle 25 games. Any others would be dumped.
    Fortunately most games have short names and you can call it what you like.
    Please Note: no commas or fullstops are allowed in a GameName.
    So in our example GameName="Death Ball"

  • HideVote=

    Self explanatory, if set to False then it will appear in the GamesMenu and players can vote for it.
    If however it is set to True, UT2Vote will hide the Game in the Game Menu.
    In our example HideVote=False

  • Clan=

    If set to False, then a ClanAdmin will not see this Game in a ClanSetup.
    This should be set to False for all DeathMatch type Games

  • RequiredPlayers=

    Here you stipulate the minumum number of Yes votes required for this game to be played.
    in our example lets say RequiredPlayers=4 as DeathBall is boring with only 2 players.

  • MapLimits=

    For the want of a better name, but this is the number of Levels that go by before any Map can be vcoted for again in this game. 0 means its always available on every level.
    In our example lets make it MapLimits=1

  • ServerName=""

    This is the Servername you want to appear in the UTBrowser or any browser for that matter and is usefull for when this gametype is playing as it identifies what game is being played. If it is just "" or "None" then it wont get used.
    In our example we will call it ServerName="JoeSoap's Deathball Game"

  • UseMapList=

    If set to False, then UT2Vote will use all the maps in the Maps folder otherwise if set to True, UT2Vote will use the maps found in this games default maplist. Just make sure you have selected some maps in the mapslist which can be done from WebAdmin or directly in your UT2004.ini file.
    In our case we set it to UseMapList=False

  • DefaultMap=""

    This is very important especially if this game becomes your DefaultGameName.
    Here you set the name of a default map that UT2Vote will use if this gametype is selected to do an auto defaultgame switch.
    In our example we use DefaultMap="DB-Cube"

  • MapPrefix=""

    Without this the MapVoteMenu will CRASH and display all sorts of garbage so make sure its correct and in uppercase.
    In our example it will be MapPrefix="DB"

    AltMapPrefix=
    Any other MapPrefix can be added here seperated by a comma, should other maps wish to be played with this game type.
    ie.. AltMapPrefix="CTF,DOM,ONS,BR"
    If the AltMapPrefix= is set to the same Prefix as the standard MapPrefix= then the game will hold 500 maps.
    A maximum of 250 maps will be devided amongst the number of prefixes given here.

  • GameClass=""

    Here I'm going to spend a bit of time here as this confuses many Admin as they often end up putting all sorts of garbage in here.
    Its only a pity that Modders don't mention there Game or Mutator ClassNames in their Readme files.... such a pity
    Some things to remember about a ClassName is it will ALWAYS be 2 names seperated by a dot.
    The best way to find a Game, Mod or Mutators ClassName is to look in the .ucl file that comes with that Mod.
    Game=(ClassName=DeathBall.DB_Deathball,GameName= etc etc.. )

    What you are interested, in all cases is the part between the Name= and the very next ',' comma.
    In this case it is DeathBall.DB_Deathball
    It is of paramount importance that you have this ClassName correct else you will not only crash UT2Vote but you will without a doubt crash your whole server as well, so if you are not 100% sure, either write to the author of the Mod or just dump the mod.
    In our example it will be GameClass="DeathBall.DB_Deathball"

  • Mutators=""

    Here you enter the Mutators ClassNames you want specifically with this game. If you have more than 1 seperate them with a comma.
    Please Note.. nowhere ever do you enter UT2Vote in as a Mutator anywhere as it will see to that itself.
    If you dont want any Mutators with this game leave it as "" or "None"
    In our example lets leave it as Mutators="None"

  • Commands=""

    Now comes the juicy part as here you setup all the game parameters you want and they are all self explanatory, but we will go through them just incase some of you are still new at startup commands.

    GoalScore=
    This is the fraglimit, goals or the number of flags needed to win the game.

    TimeLimit=
    This is the max timelimit allowed for the game. If set to 0, the game will continue till the GoalScore is reached.

    MinPlayers=
    This mainly refers to Bots on a server. If set to 2 means if there is only one player, he will play with a Bot.
    When a second player joins the game, the Bot will leave and the players carry on. If set to 0, no Bots will be allowed.

    MaxPlayers=
    The total number of players allowed on a server.

    MaxSpectators=
    The total number of Spectators allowed on a server.

    Translocator=
    Set to True or False, depends if this game uses the Translocator or not. If True the Translocator will be used.

    WeaponStay=
    Set to True or False, if set to False this game will have its weapons dissapear when picked up and respawned a while later.

    BalanceTeams=
    Set to True or False, if True and a Team type game, UT2004 will try and balance the teams equally otherwise the players need to do it manually themselves which is sometimes better as UT always screws it up :)

    ForceRespawn=
    Set to True or False, if True then when a player dies he will immediately be respawn.

    PlayersMustBeReady=
    Set to True or False, if True then everyone needs to click their Fire button to indicate they are ready before a game can start.

    Difficulty=
    Set between 1 and 7, this is the skill level that the Bots will play at.

    GameStats=
    Set to True or False, self explanatory, but if you want Bots on your server, set it to False.

    GameSpeed=
    The speed of the game set as 1.00 upto 2.00.

    FF=
    FriendlyFire setting for TeamGames and can be from 0.0 to 1.0

    NumBots=
    This only effects a local Instant Action game and has no effect on a server.
    It is basically the number of Bots you want to play with.

    AirControl
    Should an Admin wish to change a games AirControl then just add the option in the GameType string.
    In the GameType= string, if ?AirControl= is not present, UT2Vote will default the AirControl to 0.35 which is the UT2004 default.
    If the ?AirControl= is added UT2Vote will use that, and if ?AirControl=0 then UT2Vote will not adjust or use the AirControl in any way whatsoever and basically ignore it.
    However, this adjusting process happens everytime the player respawns after dying.
    If you do not want the AirControl touched in any way, and let the game control it, then add ?AirControl=0 to the GameType= commandline.

    Extras

    There are several other commands you can just add on to the end if you like, but just remember to seperate
    each one with a ? (question mark) and keep them within the "" (quotes).

    All these commands are available for the Admin in the UT2Vote AdminMenu to change at any time they wishe.

    For new games and ClassNames Download GameMake3

    Back to Headers

    Back to Top










  • UT2Vote57
    Adding extra Mutators

    Adding extra Mutators

    [UT2Vote57.UT2VoteMutators]

    bSortMutsList=True
    This will sort the ini files Mutator list alphabetically.

    To add Custom made Mutators to UT2Vote you need to copy and paste the example given and just change necessary parameters.
    Here I will give an example of the Sniper Arena Mutator.
    After copying and pasting you will have:

    Mutator=(FriendlyName="None",HideVote=False,MutClassName="None.None",Voted=False)

    FriendlyName="None"

    First you enter a Friendly name for the Mutator - keep it as short as possible as it has to fit in the Menu.
    In our case we call it FriendlyName="Sniper Arena"

    HideVote=

    Self explanatory, if set to False then it will appear in the Mutator Menu and players can vote for it.
    If however it is set to True, it will be hidden from the Mutator Menu.

    MutClassName="None.None"

    The Mutator Class Name can always be found in the .ucl file that comes with a Mutator.

    Mutator=(ClassName=SniperArena.MutSniperArena,GroupName= etc etc...)

    Voted=False

    Please leave this alone, as it is used internally by UT2Vote as an indication whether it has been voted for or not.

    Serverpackages

    Just a reminder here, all Mutators that appear in the ServerMuts= MUST be declared in the UT2004.ini ServerPackages= or added to the [UT2Vote57.UT2VotePackages]section.

    Back to Headers

    Back to Top










    UT2Vote57
    Undocumented Stuff

    BonusVehicles
    To get the BonusVehicles for Onslaught working in UT2Vote.
    Because the maps with Bonus Vehicles share the same name, UT2Vote now has some Ghost maps.
    These maps must have a Map Prefix of ECE-
    So all the maps that have Bonus vehicle capability, rename them to ECE- instead of the normal ONS- maps.
    You can have both running also for instance:
    ONS-ArcticStrongHold
    ECE-ArcticStrongHold

    Now just set the AltMapPrefix="ECE" in the GameString for Onslaught.

    AltMapPrefix
    There is aAltMapPrefix= in every GameType string.
    This gives the Admin the option of having a different type of game map in each gametype.
    AltMapPrefix="CTF" in a DeathMatch game will also show all CTF maps in the Vote menu.
    If the AltMapPrefix= is set to the same Prefix as the standard MapPrefix= then the game will hold 500 maps.
    If this is blank or has another prefix then there will be a maximum of 250 maps for each prefix.
    A maximum of 250 maps will be devided amongst the number of prefixes given here.

    Reserved Admin Spectator
    Should the server be full, an Admin can send a command from WebAdmin reserving a special Slot for himself.
    This will allow him to enter the game regardless:
    In the WebAdmin console, remove the say command and:
    UT2Vote ?AdminSpec=nickname
    This will allow an Admin into the game, and close the 'hole' when he leaves.

    Escape Key bug
    This is the bug where the Escape key does not work in custom games.
    If you want UT2Vote to handback the Escape key to Custom games,
    then add to the GameType= Command string:
    ?CustomGame=True
    This will tell UT2Vote not to block the Escape key.
    This will also help when thawing players in 3SPNs Freon game.
    NB... It is not advisable to do this for standard UT2004 games.

    Player Banning
    It is possible to ban a Player even if he has left the server.
    The Players nickname will appear in the list below a heading:
    --- Players already left ---

    Do and Donots

    -TF-Maul Mapnames
    It has been brought to our attention about a problem where the Mapname Prefix gets distorted.
    This is because certain admin break the rules and alter UT2Vote in a way it does not understand.
    The 10 Default games that are supplied with UT2Vote in the GameType section are NOT to be removed, or have their GameClasses changed in any way what so ever.
    If these games are removed UT2Vote looses its reference and also the MapPrefix="CTF" information for any particular game. If an Admin does not want that game then all he needs to do is set the HideVote=True in the GameType string.

    DefaultGameName=
    Many Admin also seems to not understand the use of the DefaultGame in UT2Vote.
    It can be some other game provided that game is in the GameType List.
    When UT2Vote first starts when your server starts, this game and its DefaultMap will be loaded.

    ServerMuts=
    There seems to be some confusion of what Mutators go in this line.
    Basically any Mutator that is Server related and not Game related goes here.
    Or any Mutator that will be used in every game, regardless of what is voted for.

    ServerLine=
    The same applies here, you do not add common commands here like ?Translocator=False etc.
    This section again is for Server related commands such as:
    ServerLine=?AdminUserName=xxx?AdminPassword=zzz

    Back to Top



    UT2Vote57
    Changes in 5.7

    Changes and Fixes in UT2Vote57

    Map Count
    Fixed the problem where the last map (250) was left out.

    Clan Maps
    Fixed problem with Clan Map sorting.
    Fixed problem with ClanSetup menu monitoring paused game.
    Fixed problem where clan map download timer expired prematurely.

    Admin Game Settings
    Fixed the problem where the Admin could not correctly set the options in the AdminGame Menu.

    Admin Leaving Server
    Fixed the problem where the Admin was not removed from the Admin list when leaving a Server.

    Tickrate
    Added ?Tickrate= option to each GameType string to adjust server tickrate.

    Top 10 Maps
    Increased to a maximum of 30 maps depending on mapname length.

    WaitForLevel
    This option has been put back in the IniOnly section and is used for slower servers that tend to dump their players if the level takes to long to changeover.
    Default is 60, but if difficulties are experienced, this should be incresed to 90.

    Spectator Spying.
    This is a new feature which has been added both Serverside and Clientside.
    When enabled on both sides and a Spectator is viewing a player, that Player will be notified via a message on his/her screen that they are being viewed.
    When the Spectator switches their view to another player, the previous player will also be notified that he/she is no longer being viewed by that particular player.
    Settings
    [UT2Vote57.UT2VoteIniOnly]

    bSpectatorSpy=True
    If the Admin sets this serverside setting as False all Spectator Spying will be disabled regardless of the Clientside settings.
    ClientMenu
    Allow Spy Messages
    Here the player has the option of checking or unchecking this option.
    If unchecked no messages will appear should a spectator be viewing this player.

    Back to Top








    Message Coloring
    Colors are in the format of R (Red) . G (Green) . B (Blue) . A (Brightness)

    Some examples of color settings are as follows:

    Red 255.0.0.255
    Brown 140.64.0.255
    Pink 255.140.140.255
    Blue 0.0.255.255
    White 255.255.255.255
    Black 0.0.0.255
    Lime 0.255.0.255
    Green 0.160.0.255

    For more colors see: http://www.tayloredmktg.com/rgb/

    NB.. Any errors entered and the Message Color will revert to Silver : 200.200.200.255

    Back to Top