UT2Vote40 - (c) ProAsm 2004

http://www.unrealza.co.za/proasm

email: ProAsm

-------------- Credits -----------------

Socke

PoW

Imaginos

sh0V3L

tuco

CvRoy

Yakomo

Slutty_Bitch

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


MANUALS:
Please visit these sites for a full detailed description for UT2Vote40.

http://www.unrealza.co.za/proasm

Detailed Manual in German and English:

http://www.1337noob.de/ut2vote/

Quick Links

Installation
Ini file settings
Clientside settings
Clan Setup
ServerPackages














Installation

============

 

NB. Dont forget...

[Engine.GameEngine]
ServerPackages=UT2Vote40

 

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

UT2Vote40.u

UT2Vote40.int

UT2Vote40.ucl

UT2Vote40.ini

 

UT2Vote40 needs to be added as a Mutator in your Server startup commandline as follows:

?Mutator=UT2Vote40.UT2Vote

 

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

 

[Engine.GameEngine]

ServerPackages=UT2Vote40

 

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.

For example:

ServerMuts=ServerBots.ServerBots,UnrealGame.MutLowGrav,XGame.MutNoAdrenaline

 

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=.

 

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.

 

DefaultGame=

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: DefaultGame=XGame.xDeathMatch

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.

 

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.. All Admin changes will need a level restart.

Back to Top







UT2Vote40.ini
Ini file configuration settings

Settings under the heading:

[UT2Vote40.UT2Vote]

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.. These Admin loose there Adminship when they die. They can of course logout with:
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.

DefaultGame=
This is whatever 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.
This can be changed at any time by you logging on as Main or Server Admin then calling up the Admin Menu:

You will see a checkbox (Set as Default Game) - just tick it and hit submit.
Basically now what happens is every 2 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 switchyour 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.

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 little Yes/No VoteCast 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 :)

bTallyOverlay
 If set to True, then the Tallyvotes will be overlayed on the Map Image.

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

bAdrenDisable=
 If set to True, all Adrenaline capsules will be disabled from the game.

bComboAdren=
 If set to True, all frag and Combo Adrenaline will be disabled.

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

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 UT2Vote40.UT2Vote
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

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

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

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.
NB.. If SkinBright is greater than 100, bColorSkins will be disabled.

bNoWeapShake=
 Players weapons will not shake if set to True.

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 ****

SkinBright=
 This can be set between 0 and 254 and effects the brightness of all Player and Bot skins.
Best effect is around 250.
Any value below 50 will disable this function and force it back to the UT2004 default

[UT2Vote40.UT2VoteVoting]

 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.

bChangeVote=
 This allows players to change their vote once during a voting session.

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

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.


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

 [UT2Vote40.UT2VoteIniOnly]

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

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

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

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.

bCheckMaps
 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.

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

bUseGameName
 If set to True, then the GameName used in the GameType string will be displayed in the Games ScoreBoard.

bSwitchDefMap
 If set to True, then after 3 minutes if there is no players on a server it will switch to the DefaultMap.

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.

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

bNoWeapStats
 With some slower servers the Weapons Stats can generate a bit of lag.
In these cases it may be advisable to set this to True.

DefaultSwitch
 This is the time in minutes from 0 to 9 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.

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

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

NumHitSound=
 A select from 1 to 5 for different weapon hit sounds.
Setting this to 0 will turn the hitsounds off.

Back to Top







UT2Vote40
Clientside configuration settings

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

 [UT2Vote40.UT2VoteClient]
bDefineSetup=True
bNoWeaponNames=True
bEndScoreBoard=False
bShowSpectators=True
bEndGameShot=False
bNoAnnouncer=False
bDisableHomeKey=False
bUseHitSounds=True

 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 disabledt.

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

bUseHitSounds=
When this is set to True, all weapons will have hitsounds.


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.

WeapStats
Click this button to view your Weapon Stats of the current game (if available).

Back to Top







UT2Vote40
Clan Setup

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.

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.

Back to Top







UT2Vote40
ServerPackages

Just a reminder here, all Mutators that appear in the ServerMuts= MUST be declared in the UT2004.ini ServerPackages=

[UT2Vote40.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.

Back to Top