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