Subscribe to download
Raf's MapVote

Raf's MapVote is a server addon for Garry's Mod that allows players to vote for the next map to be played. This addon is specifically tailored for the Trouble in Terrorist Town (TTT) gamemode, but includes admin commands to be manually started with any gamemode.

• Keeps track of how many times each map has been played.
  
• Ability to choose specific maps to be in the mapvote rotation or use all the maps located on the server, with the ability to filter them by prefix (e.g. ttt_, cs_").
  
• A static number of candidate maps (6). Candidates maps consist of 3 "popular" maps and 3 random maps. "Popular" maps have the highest play count on the current server. There's also a "random" button for the indecisive and an "extend" button to vote for extending the current map.
  
• Cooldown system. After a map has been played, it won't show up as a candidate for a number of maps (configurable).
  
• Ability to use map thumbnails from other addons (e.g. ttt_map_icons) or insert a custom image for each map (this option would require to force the clients to download the image as well).
  
• Rock the vote implementation, to skip a map, if the majority (configurable) votes to do so.
  
• A map pool screen, that any player can open by typing "!rmvpool". This shows the maps currently included in the map pool, as well as tagging maps on cooldown.
  
• Darkmode/lightmode color schemes that are saved as a convar "rmv_lightmode 1/0".
  
• Admin console command "rmv_start" to manually start the mapvote.
  
• ULX integration - ability for admins to manually start the mapvote with the "ulx rmvstart" command or through the graphical menu.

The config file is automatically generated after running the server once with the addon installed in "garrysmod/data/rafsmapvote/config_rafs_mapvote.json".

• MAPS : ["cs_office", "ttt_67thway_v3"] - Custom map pool. If left empty, will use every map on the server, taking into account the given map prefixes. If setting a custom map pool, you should always have at least 6 + MAP_COOLDOWN amount of maps in the map pool, to avoid potential issues.
  
• MAP_PREFIX : ["ttt_", "cs_"] - Filters the map pool with the given prefixes.
  
• MAP_COOLDOWN : 5 - Map changes before a recently played map can be a mapvote candidate.
  
• TIMER : 45 - Vote time in seconds.
  
• NO_VOTE_TO_RANDOM : false - If a player doesn't vote, does it vote go to a random candidate.
  
• RTV_MIN : 3 - Minimal player count on the server, for RTV to be enabled.
  
• RTV_TIME : 300 - Time in seconds after which RTV is enabled.
  
• RTV_PERCENT: 0.6 - Percentage of players needed to RTV.
  
• DATA_DIR : "rafsmapvote/" - Data directory. You shouldn't change this.
  
• THUMBNAIL_DIR : "rafsmapvote/thumbnails" - Directory to place your custom thumbnails, they should have the filename ttt_mapname.jpg/.png. If placing images here, you are responsible for sending them to the client.
  
• FORCE_VOTE_USER_GROUPS: ["superadmin"], ["admin"] - Roles that can force the mapvote by using the "rmv_start" console command. If using ULX, you should prefer to use the appropriate ULX command and setup permissions there.

Thumbnail icons are prioritized as follows:

1. Custom .png or .jpg files under THUMBNAIL_DIR (e.g. data/rafsmapvote/thumbnails/ttt_MAPNAME.jpg)
   
2. Map thumbnails in maps/thumb/ (this also usually includes addons like ttt_map_icons)
   
3. Defaults to "no map preview" image

• !rmvlist, !mappool, !rmvpool - Opens a map list window where the player can view the current server map pool.
  
• !rtv - Vote to rock the vote.
  
• !rmv [duration] [noVotesToRandomVotes] - Force starts the mapvote through ULX (ULX custom permissions apply).

• rmv_lightmode 0/1 - Toggles the "light mode" color scheme.
  
• rmv_start - Force starts the mapVote, if player is under a FORCE_VOTE_USER_GROUPS (config) player group.
  
• ulx rmvstart [duration] [noVotesToRandomVotes] - Force starts the mapvote through ULX (ULX custom permissions apply).