Latest revision as of 21:20, 4 July 2012

Odamex offers a robust set of voting options to server administrators that allows them to give varying levels of control to the player.

Server

Vote Modifiers

The vote system offers a variety of options to server administrators that allow votes to be carried out following certain rules.

Count Absentee Votes

Usage: sv_vote_countabs (#)

When enabled, will not count non-votes as either a "yes" or "no" after the vote timelimit has expired. When disabled, non-votes will be counted as a "no" after the time limit has expired.

Vote Majority

Usage: sv_vote_majority (#)

Percentage of "yes" votes needed for a vote to pass. Default value is 0.5 (50%).

Vote Timelimit

Usage: sv_vote_timelimit (#)

The amount of time that clients can participate in a vote. Measured in seconds, the default value is 30.

Vote Timeout

Usage: sv_vote_timeout (#)

The amount of time a client must wait to call another vote if their first failed. Measured in seconds, the default value is 60.

Types of Votes

There are a number of different types of votes available for server administrators. They can all be easily turned on or off.

Coinflip

Usage: sv_callvote_coinflip (0-1)

Allows clients the ability to flip a coin. Returns either heads or tails in a text string.

Force to Spectator

Usage: sv_callvote_forcespec (0-1)

Allows clients the ability to force an active player into spectator mode.

Fraglimit

Usage: sv_callvote_fraglimit (0-1)

Allows clients the ability to change the fraglimit through a vote.

Kick

Usage: sv_callvote_kick (0-1)

Allows clients the ability to kick other players from the server through a vote.

Map

Usage: sv_callvote_map (0-1)

Allows clients the ability to change the map through a vote. All maps in the server's maplist can be voted on by the players.

Nextmap

Usage: sv_callvote_nextmap (0-1)

Allows clients the ability to force the server to the next map in the maplist.

Random Captains

Usage: sv_callvote_randcaps (0-1)

Allows clients the ability to have the server choose two "captains" from in-game players or spectators which have used the ready command. It will set them both to separate teams in team games. Commonly used for private CTF games.

Random Map

Usage: sv_callvote_randmap (0-1)

Allows clients the ability to have the server jump to a random map from its maplist.

Random Pickup

Usage: sv_callvote_randpickup (0-1)

Allows clients the ability to have the server shuffle teams with a designated number of players.

Restart Map

Usage: sv_callvote_restart (0-1)

Allows clients the ability to have the server reload the current map.

Scorelimit

Usage: sv_callvote_scorelimit (0-1)

Allows clients the ability to change the scorelimit through a vote.

Timelimit

Usage: sv_callvote_timelimit (0-1)

Allows clients the ability to change the timelimit through a vote.

Client Commands

Voting in Odamex is very simple. The client issues the callvote command through the console with the proper parameters. The client can bind keys to vote yes or no through the Customize Controls menu. The player that calls the vote automatically is assumed to be a yes vote from the start.

Coinflip

Usage: callvote coinflip

Result of the coinflip will be output in a message from the server.

Force to Spectator

Usage: callvote forcespec (Player ID #)

The player ID # can be found by using the players console command.

Fraglimit

Usage: callvote fraglimit (#)

Substitute the # with the new desired fraglimit.

Kick

Usage: callvote kick (Player ID #) (reason)

The Player ID # can be found by using the players console command. Anything entered after the Player ID # will be printed as the reason, though a reason is not necessary.

Map

Usage: callvote map (Map ID #) or callvote map ***

There are a number of ways to vote for maps. In order to see what maps are available for vote, use the maplist command. The maplist will print with an id # for each map. However, you can also vote for maps using wildcards.

For instance, if maps 1-20 from dwango5.wad are on the server, you could use the command callvote map dwango5 map18 to pull up a vote for map18. If dwango5 is the ONLY wad on the server and there are no other map18 entries in the list, you could simply do callvote map map18. If a wad has a single map, such as the common duel map found in judas23_.wad, you could issue the command callvote map judas. Feel free to experiment with these wildcards. Odamex will not allow you to make a mistake if there are too many possible results for what you are trying to vote.

Nextmap

Usage: callvote nextmap

Random Captains

Usage: callvote randcaps

For use in team games. See Types of Votes above for more information.

Random Map

Usage: callvote randmap

Random Pickup

Usage: callvote randpickup (#)

For use in team games, will randomly shuffle in-game players and spectators who have used the ready command. Substitute # for the total number of players you want to be shuffled. If you want a 3 vs 3 game, use the number 6. If you want a 5 vs 5 game, use the number 10.

Restart Map

Usage: callvote restart

Scorelimit

Usage: callvote scorelimit (#)

Substitute the # with the new desired scorelimit.

Timelimit

Usage: callvote timelimit (#)

Substitute the # with the new desired timelimit. Measured in minutes.