Unreal Tournament Challenge Voting Mutator
Version 1.5

http://www.badct.de/utc/

================
What is it?
================
Unreal Challenge is a powerful Mutator for Unreal Tournament that allows remote clients (Players) to vote on a large number of variables (fully configurable by server admin).

================
Whats new?
================
see file UTCV_whatsnew.txt

================
Installation
================
UMod version
Double click the file. Done :)
or install it manually with 
drive:unrealtournament\system\setup.exe install drive:pathto\utcv.umod

Zip version
Extract all files in the zip to your drive:unrealtournament\system folder

If you want to install any plugins, be sure you downloaded them from
http://www.badct.de/utc/

====================
Server Configuration
====================

Please Open the utcv.ini file with any text editor, I have added comments to explain how to set variables;
and then paste the content of the file into your UnrealTournament.ini/server.ini

if you have any question, feel free to ask me via the utcv board at http://www.badct.de/utc/.

===================================
How do I use utcv during the game ?
===================================

This are all console commands and you could use it during the game.

the following console commands are available:
mutate VOTE [option] [value] - calls a vote
mutate VOTECANCEL - cancels a vote(can only be done from the votecaller)
mutate VOTEYES - votes yes
mutate VOTENO - votes no
mutate VOTE RESTART - restarts the current map
mutate ECHO [message] - echo a message
mutate UTCVREC [demomask] - records a demo with given demomask(optional), (demorecplugin)
mutate SHOW STATS - prints out some stats
mutate SHOW MAPS - shows the current maplist for voting
mutate SHOW MODES - shows the current modelist for voting
mutate SHOW INFO - shows the votable options
mutate SHOW GAMEINFO - shows infos about the current game
mutate SHOW PLAYERS - shows which players are ready
mutate SHOW VOTE - shows the current vote
mutate HELP - shows this screen

a server admin may choose to disable any combination to the following:

mutate vote kick [value] - kick a player, value is the player name you want to kick to
mutate vote kickid [value] - kick a player, value is the playerid you want to kick to
mutate vote crec - votes for clientside automatic demorecording (demorecplugin)
mutate vote srec - votes for serverside automatic demorecording (demorecplugin)
mutate vote map [value] - change the map, value could be mapid or mapname
mutate vote mode [gamemodeid] - change the gamemode
mutate vote fl [value] - change the fraglimit/teamscorelimit
mutate vote tl [value] - change the timelimit
mutate vote mp [value] - change the maxplayers countmutate vote ms [value] - change the maxspectators count
mutate vote ff [value] - friendly fire, value could be between 0 and 100
mutate vote ws [value] - weapons stay, value could be true/false/on/off
mutate vote tr [value] - translocator, value could be true/false/on/off
mutate vote tm [value] - tournament mode, value could be true/false/on/off
mutate vote sm [value] - mute spectators, value could be true/false/on/off
mutate vote ms [value] - set maximum spectators to [value]
mutate vote ng [value] - turns ngWorldStats logging on/off, value could be true/false/on/off
mutate vote AP [value] - switch autopause on/off, value could be true/false/on/off
mutate vote AM [value] - set the maximum pause time to [value] minutes(per team)
mutate vote AT [value] - set the maximum total pause time to [value] minutes(per team)

mutate LOGIN [pass] - became a utcv administrator.

utcv administrator commands:
mutate UTCVPASS [pass] - set a new UTCV Adminpassword
mutate NETTICKRATE [value] - set the maximum nettickrate 
mutate LANTICKRATE [value] - set the maximum lantickrate 


================
How to use UTCV!
================

To propose a vote the following syntax is used in the console;

mutate vote (vote option) (value)

After a vote has been proposed a messages displays on screen briefly telling who proposed the vote and what it is. You then have 2 mins to vote.

type in the console, or bind to a key:

mutate voteyes
or
mutate voteno

50%(or what the server admin did decide) or over of the players must vote yes for the vote to be successful.

VOTE TO CHANGE MAPS

To change Maps first you must find out the ID of the map you want (varies depending on Mode and what the server admin has loaded). Use the key you have bound for MapList (See above) or type in the console:
mutate show maps

It will display something like the following:

[1]dm-codex
[2]dm-curse][
[3]dm-deck16][

The list will be displayed onscreen, typically onscreen there is too much information and only the last 4 lines are shown, simply open the console to view in entirity. The list will vary depending on Mode, if you change Modes (see below), display the maplist again to see whats available.

Note the number in the square brackets [] corresponding to the map you want, this is the mapid.
To vote for that map, type in the console;
mutate vote map (mapid)

For example the following will propose a vote to change to dm-deck16][ (based on above list)

mutate vote map 3

The vote will then appear (as proposer, your vote is already cast and you don't need to vote).  Once passed all votes are instant, maps will change approx 10 seconds after a successful votes.

Restart current map
To restart the current map:

mutate vote restart


VOTE TO CHANGE MODES (Gametypes, if enabled by admin)
To change modes you must first decide the gametype (mode) you want.
The Modelist key (see above) or in the console;
mutate show modes
will show you the list of modes enabled;

1- DM
2- Duel (1v1) *NOTE set to No Powerups and No redeemer, 2 players Max
3- Clan Match (TDM)
4- CTF Game
5- LMS Game
6- DOM Game
7- Assault

Note the number corresponding to the mode you want, this is the modeid.
To vote for that mode, type in the console;
mutate vote mode (modeid)

For example the following will propose a vote to change to CTF Game

mutate vote mode 4

The vote will then appear (as proposer, your vote is already cast and you don't need to vote).  Once passed all votes are instant, modes have built in default maps (as set by admin), the maps will change in about 10 seconds after successful votes. Once the default map is loaded you may then change to any map available in that mode (if enabled)in the list see above.
*Note the server admin may change the modes to DM games with different mutators for example, the above is the default in the .ini file.

==================
Misc Information
==================

Each vote must get over 50%(default) of users to be successful.

Votes are only active for finite period (default 1 min)

Bots are not counted in votes.

Spectators can NOT vote or propose votes and votes will not be displayed to them.

Once changed to a gamemode the maps will cycle according to what the server admin has set, if no map cycle is set then the map will repeat.

When a Mode\Map change is successful the map will change, it will NOT wait for end of level (Frag or Time limt) to the default map set for that mode (as determined by the .ini)

++++++++++++++++++
Credits
++++++++++++++++++

Code: Mr.Frost
http://www.badct.de
http://www.ocrana.de

Idea and Motivation: eb-blade

Website: x3ntor

Documentation: Quietman[RT], SuicideSmurf, Mr.Frost
http://www.ozunreal.com

12.02.2002 (c) Mr.Frost
12.08.2000 (c) [BADCT]Mr.Frost