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
- Open Utilities > Voting.
- Set Vote time (s).
- Type the question under Poll and fill in the options.
- Click Start poll. The result is announced on every screen when it ends.
Let players pick the next map
- Click Start a map vote from the map pool (nominations first).
- Players press the number of a thumbnail.
- When time runs out, the winner loads after 10 seconds.
Offer a short list of maps
- Search the map list and Ctrl+click the maps you want.
- Untick Add "Stay on this map" if the map must change.
- Click Start a map vote with the picked maps.
Change maps automatically
- As a superadmin, set Automatic map vote after (minutes, 0 = never), for example 45.
- Click Apply the numbers above.
- 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_mapsmaps. - 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,
!rtvis 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.