Tutorial / Admin panels > Utilities

Voting

Start polls, map votes and server mode votes, manage the map pool, and set rock the vote, nominations, kick and mute votes and elections.

What it does

Voting runs up to three votes at once, tagged A, B and C. Each vote shows as a box on the left of every screen. Map votes show as a row of map thumbnails at the top.

Players vote with the number keys, which go to the first vote they have not voted in yet. They can also type !vote <number> or !vote <A/B/C> <number>. The box the number keys go to is blue.

From this panel you start polls, map votes and server mode votes, end or cancel running votes, and keep the map pool. Superadmins also set rock the vote, nominations, automatic map votes, kick and mute votes and job elections.

Where to find it

Q menu > KGX's Admin Toolbox > Utilities > Voting.

  • Starting, ending and cancelling votes: admins, or players ticked for Voting in Player Access.
  • Map pool and Settings: superadmins only (the controls are greyed out for others).
  • Player chat commands work for everyone (see below).

The panel

Running votes
Option What it does Default Range
Vote list Columns Tag, Kind, Question, Left (seconds), Votes.
End the selected vote now (count the votes) Ends the vote and applies the result. With nothing selected, the newest vote.
Cancel the selected vote (no result) Stops the vote without a result.
Vote time (s) How long the polls, map votes and mode votes you start from here run. 30 10-300
Poll
Option What it does Default
Question Up to 120 characters. Required. empty
Option 1-6 Up to 6 answers of 40 characters. Options 3 to 6 are optional. Duplicates are dropped. Yes, No
Start poll Starts the poll. The most votes wins; a tie is picked at random.
Map vote
Option What it does Default
Start a map vote from the map pool (nominations first) Nominated maps first, then random pool maps, plus "Stay on <map>".
Status line Map pool size, nominations, rock the vote count, and the next automatic map vote.
Search box and map list Columns Map (Ctrl+click to pick up to 9), Pool, Recent. The current map is not listed.
Add "Stay on this map" Adds a stay option to a vote with picked maps. On
Start a map vote with the picked maps A vote with the maps you selected. Needs 1 map with "Stay", else 2.
Clear the nominations Removes every player's nomination.

The winning map loads after a 10 second countdown. "Stay" or "Extend" keeps the map.

Mode vote
Option What it does
Vote on the server mode (Sandbox, Build / PvP, RP) Players pick the server mode. The winner sets kgxat_playmode.
Map pool (superadmins)
Option What it does
Add the picked maps to the pool Adds the selected maps.
Take the picked maps out of the pool Removes the selected maps.
Empty the pool (every installed map) After a confirm, clears the pool. An empty pool means every installed map.
Settings (superadmins)
Option Setting Default Range
Rock the vote (!rtv) kgxat_rtv On
Rock the vote: percent of players needed kgxat_rtv_ratio 60 10-100
Rock the vote works after (minutes) kgxat_rtv_wait 5 0-60
Nominations (!nominate <map>) kgxat_nominate On
Maps in a map vote kgxat_mapvote_maps 6 2-9
Recent maps left out (map changes) kgxat_mapvote_cooldown 3 0-20
Map vote time (s) kgxat_mapvote_time 30 15-120
Automatic map vote after (minutes, 0 = never) kgxat_mapvote_auto 0 0-600
"Extend the map" adds (minutes) kgxat_mapvote_extend 15 5-120
Times a map can be extended kgxat_mapvote_extends 1 0-5
Kick votes (!votekick <name> [reason]) kgxat_votekick Off
Mute votes (!votemute <name> [reason]): voice and chat kgxat_votemute Off
Kick and mute votes only while no admin is online kgxat_votekick_noadmins On
Yes votes needed (percent) kgxat_votekick_ratio 60 50-100
Fewest yes votes kgxat_vote_minyes 3 1-32
Fewest players online kgxat_vote_minplayers 4 2-64
Ban a vote-kicked player for (minutes, 0 = kick only) kgxat_votekick_ban 0 0-1440
Mute for (minutes) kgxat_votemute_minutes 10 1-120
Seconds between one player's kick or mute votes kgxat_votekick_cooldown 300 30-3600
Elections for jobs set to "Elected by vote" (Settings > Jobs) kgxat_elections On
Seconds to run for the job kgxat_election_join 30 10-120
Election vote time (s) kgxat_election_time 30 15-120
Apply the numbers above Sends the sliders to the server.

How to use it

Ask the players a question
  1. Open Utilities > Voting.
  2. Set Vote time (s).
  3. Type the question under Poll and fill in the options.
  4. Click Start poll. The result is announced on every screen when it ends.
Let players pick the next map
  1. Click Start a map vote from the map pool (nominations first).
  2. Players press the number of a thumbnail.
  3. When time runs out, the winner loads after 10 seconds.
Offer a short list of maps
  1. Search the map list and Ctrl+click the maps you want.
  2. Untick Add "Stay on this map" if the map must change.
  3. Click Start a map vote with the picked maps.
Change maps automatically
  1. As a superadmin, set Automatic map vote after (minutes, 0 = never), for example 45.
  2. Click Apply the numbers above.
  3. After 45 minutes on a map a vote starts by itself with an "Extend the map" option while extends are left.

Settings and commands

Command Who What it does
!vote <number> Everyone Vote in the first vote you have not voted in.
!vote <A/B/C> <number> Everyone Vote in a given vote. You can change your vote.
!rtv or !rockthevote Everyone Ask for a map vote. Enough players start one.
!nominate <map> Everyone Put a pool map into the next map vote. One nomination per player.
!nominations Everyone List the nominations.
!maps Everyone List the map pool, with maps on cooldown marked.
!votekick <name> [reason] / !votemute <name> [reason] Everyone, when on Start a kick or mute vote.
kgxat_vote <number> or kgxat_vote <A/B/C> <number> Everyone Console version of !vote.

Tips and limits

  • A fourth vote is refused until one of the three ends. Only one map vote and one mode vote run at a time.
  • A map vote with picked maps still holds at most kgxat_mapvote_maps maps.
  • Maps played in the last few map changes are left out of map votes and nominations unless there are not enough others.
  • When the players choose to stay, or nobody votes, !rtv is blocked for 5 minutes.
  • v3.6.14: Utilities > Game Modes > Next match runs its own votes between matches: "Which mode next?" (Game Modes modes) and, every N matches, a map vote. They use one of the three vote slots like any vote.
  • Kick and mute votes never target toolbox admins, the target cannot vote, and the starter votes yes.
  • The time between one player's kick or mute votes is kept by SteamID, so rejoining does not reset it. A mute vote that passes after its target left applies when they come back.
  • The map pool and map history are saved in data/kgx_admin_toolbox/mapvote.json. Nominations and rock the vote reset after each map vote.
  • Thumbnails come from maps/thumb/<map>.png. Maps without one show a grey box.
  • Number keys only vote while a vote is waiting for you; otherwise they switch weapons as usual.

Back to Admin panels

Type to search every tool, panel, setting, FAQ answer and release.