Teeworlds Server Voting Setup
Add custom vote options to your Teeworlds server using add_vote, let players vote yes/no with F3/F4 in-game, and configure vote-kick and vote-map permissions.
Teeworlds Server Voting Setup
Teeworlds has a built-in vote system. Players press F3 (yes) or F4 (no) to vote on options you configure, or to initiate vote-kicks and map changes.
Adding Vote Options
Use add_vote in autoexec.cfg or via RCON:
add_vote "Label shown to players" "server command to run"
The label appears in the vote menu; the command runs if the vote passes.
Examples:
add_vote "Change to CTF5" "sv_gametype ctf; change_map ctf5"
add_vote "Change to DM1" "sv_gametype dm; change_map dm1"
add_vote "Restart Round" "restart"
add_vote "Enable Friendly Fire" "sv_teamdamage 1"
add_vote "Next Map" "change_map dm2"
Multiple commands in a single vote action are chained with ;.
How Players Vote
- Player opens the vote menu in-game (default: F1 shows options, or the server broadcasts a vote prompt)
- When a vote is active, press F3 to vote yes, F4 to vote no
- If the majority votes yes within the time limit, the command executes
Clearing All Votes
Remove every configured vote option:
clear_votes
Use this via RCON when you want to reset the vote menu entirely and re-add updated options.
Vote-Kick
sv_vote_kick allows players to initiate a vote to kick another player.
sv_vote_kick 1
sv_vote_kick_bantime 5
sv_vote_kick_min 3
| Setting | Description |
|---|---|
sv_vote_kick |
1 = vote-kick enabled, 0 = disabled |
sv_vote_kick_bantime |
Minutes the kicked player is banned; 0 = just kick, no ban |
sv_vote_kick_min |
Minimum players on the server before vote-kick is allowed |
Vote-Map
sv_vote_map allows players to vote to change the current map to any map in the rotation.
sv_vote_map 1
When enabled, players can select a map from the vote menu. This uses the sv_maprotation list to determine which maps are available for voting.
Full Vote Configuration Block Example
Place in autoexec.cfg:
sv_vote_kick 1
sv_vote_kick_bantime 5
sv_vote_kick_min 3
sv_vote_map 1
add_vote "Map: dm1 (Deathmatch)" "sv_gametype dm; change_map dm1"
add_vote "Map: dm6 (Deathmatch)" "sv_gametype dm; change_map dm6"
add_vote "Map: ctf5 (Capture the Flag)" "sv_gametype ctf; change_map ctf5"
add_vote "Map: ctf1 (Capture the Flag)" "sv_gametype ctf; change_map ctf1"
add_vote "Restart Round" "restart"
add_vote "Enable Friendly Fire" "sv_teamdamage 1"
add_vote "Disable Friendly Fire" "sv_teamdamage 0"
Notes
- Vote options persist until
clear_votesis called or the server restarts - Add
add_votelines toautoexec.cfgto restore them automatically each start - Votes that change
sv_gametypeshould also callchange_mapto a compatible map in the same command