UT2Vote21 - (c) ProAsm 2004

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

email: proasm@stormnet.co.za

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

Socke    - alte.Socke@gmx.net

Yakomo   - yakomo@debitel.net

PoW      - pow@ut-justforfun.net

CvRoy    - cvroy001@earthlink.net

Imaginos - bill@imaginetworks.com

sh0V3L   - crosz@speakeasy.net

Nikki    - vvvnikki@yahoo.com

NexXxus  - ut-admin@cox.net

MikeDr   - mikedr2@earthlink.net

Cartman  - gh@ghaering.de

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


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

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

Detailed Manual in German and English:

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

Quick Links

Installation
Ini file settings
Clientside settings
New Clan Setup
Fixes and Additions in 2.1














Installation

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

 

NB. Dont forget...

[Engine.GameEngine]
ServerPackages=UT2Vote21

 

Please Note:

UT2Vote21 requires Patch 2225 and the EpicBonuspack installed.

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

UT2Vote21.u

UT2Vote21.int

UT2Vote21.ini

 

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

?Mutator=UT2Vote21.UT2Vote

 

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

 

[Engine.GameEngine]

ServerPackages=UT2Vote21

 

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.

 

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










UT2Vote21.ini
Ini file configuration settings

Settings under the heading:

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

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 :)

bPlayerLights=
This just tells UT2Vote whether players should have shoulder lights on during a DeathMatch game.
This has no effect on TeamGames.

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 UT2Vote21.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 UT2003 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.

bSkinGlow=
If True then the next function is available for setting the value.

SkinGlow=
This can be set between 20 and 250 and effects the brightness of all Player and Bot skins.
Best effect is around 100.
Any value below 20 will disable this function and force it back to the UT default of 40
or 70 if you have bBrightSkins=True

GameEndWait=
This is the time in seconds that UT2Vote waits for a map to be voted for.
Should a map not get voted for in the prescribed time, UT2Vote will display a message and switch to the next map on the list or just a random map.

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

[UT2Vote21.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:

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

bDisWarmupIfTTM
If set to True, then the UT2Vote Warmup in a ClanMatch will be disabled if TTM is running.

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.

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.

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.

bForceShaking=False
If set to True, then the Client option to disable his weapon shaking will be disabled.

bDisHitSounds=False
If set to True, then the Client option for selecting weapon HitSounds will be disabled.

Back to Top










UT2Vote21
Clientside configuration settings

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

[UT2Vote21.UT2VoteClient]
bDefineSetup=True
bUseHudCounter=False
bResetWhenDead=False
bHudCountUp=True
bUseGameTime=False
bUseElapsed=False
bNoWorldShake=True
bNoWeaponNames=True
bDisplayTime=False
bSeeThruHudDM=False
bEndScoreBoard=False
bShowSpectators=True
bEndGameShot=False
bSeeThruMenu=False

bNoAnnouncer=False
bDisableHomeKey=False
bUseHitSounds=True

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

bUseHudCounter=
This the client can set to True if he/she wants the Hud Counter enabled.

bResetWhenDead=
If the client wants his/her Counter reset when they are killed.

bHudCountUp=
This is whether the client wants his/her Counter counting up or counting down.
The HudCounter counts from 00 to 99 or the other way round and then restarts.

These Keybinds can be added by the Client if he/she so wishes:
Pressing this key will then reset the HudCounter.
ResetHudTimer
This number can be anything from 00 - 99 and the counter will count either up or down from that number.
ResetHudTimer Number

bUseGameTime=
An alternate oprion to the HudCounter. Setting this to True will enable display of either Remaining or Elapsed time.

bUseElapsed=
Setting this to True will enable Elapsed time over Remaining time.

bNoWorldShake=
If enabled ServerSide the the Client will have this option to stop the world shaking when firing.

bNoWeaponNames=
This is already available by UT2003 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.

bDisplayTime=
Setting this to True will enable the display of the PC local time.

bSeeThruHudDM=
When this is set to True, in DeathMatch games your Hud will be transparent.

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.

bSeeThruMenu=
When this is set to True, all Menus will be transparent.

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.

Back to Top










UT2Vote21
Fixes and Additions in 2.1

Fixes

WebAdmin
In version 2.0 if bUseChatLog=False then the Console commands in WebAdmin for UT2Vote did not work, regardless if bWebAdmin was True or False.

In Game Voting
A bug in which the vote could expire depending on when the 1st player made a vote.
This would be invisible to the voters and just nothing would happen even if everyone voted the same.
Also some players would not be able to get the Menu up even though a Vote was in process.

Deaths Display
In 2.0 the number of Deaths displayed in TTM during a Teamgame was missing.

Additions

[UT2Vote21.UT2VotePackages]
Packages=(MutClassName="Whatever.Whatever", ServerPackages="Whatever")
Added new Packages section for Admin to add Packages for large Mutators that they dont want players to download everytime they join a server.
When one of these Mutators are voted or added to a GameType, only then will the Package be added to the ServerPackages and downloaded to the client if they dont already have it.
All Mutators that you want added to the ServerPackages need to go here.
The ServerPackages= section can have multiple packages seperated by commas.

Home Key
There now is an option in the Client Menu to disable the Home key. bDisableHomeKey=True in User.ini file

The Menus
All menus have been tweaked and adjusted to fit better.

The Escape Key
The Escape key will now also Close ALL Menus regardless of where you are, except the ClientMenu simply because of the KeyBind functions in the ClientMenu

The Bonuspack
The requirement for the Bonuspack to be present on a Server has been removed.
However servers that have the Bonuspack they will not notice any change in UT2Vote at all except the Mutant Hud will be available.

Sub Heading
Created a new Sub Heading in the UT2Vote ini file:
[UT2Vote21.UT2VoteVoting]

VoteMinTime (Default 30)
The total amount of time allowed before timeout for 2 Players.

VoteMaxTime (Default 120)
The maximum time allowed regardless how many players are on the server.

VoteStepTime (Default 7)
The additional time allowed for every player after the VoteMinTime.

VoteIdleTime (Default 15)
Is the time that after everyone has voted and idles for this period, the VoteMaxTime will be forced and the vote decided.

Announcer On/Off
This option has been added to the Client Menu.

bForceShaking
This has been added to the IniOnly section and if set to True, it will bypass the Clients option to switch off his "WorldShaking" and force it to be enabled.

Spectator Admin
This Admin can now enter at Game end to do whatever he needs to do.

Hit Sounds
Added options for HitSounds clienside in Client Menu.
Also added bDisHitSounds= in IniOnly section to force disable Client HitSounds.

Clan Admin
Added where a Clan Admin can no longer ban Players.

Transparency
Added where the AddNew button toggles with a SeeThru button if Admin not present.
Transparency will switch immediately.

Spectate Button
Added where the Admin button toggles with a Spectate button if Admin not present.

bUseRandomMap
This was added to the IniOnly section and if set to True, a Random Map from the Server Maps folder will be chosed when no-one votes and the vote times out.
Currently it always switches to the default map.

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.

Admin Game Menu.
The Admin Game menu has been revamped and updated with some options.

Friendly Fire
This option has been added to the Admin Game menu.

ServerPackages
UT2Vote will now Add/Remove all Mutator ServerPackages, except any Default UT2003 Mutators.
This is so players do not have to download a pile of Mutator packages when joining your server.

Back to Top










UT2Vote21
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