Map Management Plugins (SourceMod)

This articles refers to the plugins provided with SourceMod 1.1 and newer.

Plugins

Mapchooser

• Provides a central map voting interface for other plugins to use and optional automated end of map voting.
• Uses the maplists.cfg “mapchooser” section.
• Disabled by default

Nominations

• Requires mapchooser
• Adds user/admin nominations into mapvotes.
• Uses the maplists.cfg “nominations” section.
• Disabled by default

Rockthevote

• Requires mapchooser
• Adds rockthevote functionality (forced early voting) to mapchooser.
• Disabled by default

Nextmap

• Automatically selects a nextmap at the start of each map
• Follows the mapcycle specified by the 'mapcyclefile' cvar.
• Provides map history and mapcycle listings.

Randomcycle

• Randomly selects a nextmap at the start of each map.
• Uses the maplists.cfg “randomcycle” section.
• Disabled by default

Cvars

Cvar	Plugin	Default Value	Description
sm_nextmap	Core		The Next Map that SourceMod will change to.
sm_mapvote_endvote	Mapchooser	1	Specifies if MapChooser should run an end of map vote.
sm_mapvote_start	Mapchooser	3.0	Specifies when to start the vote based on time remaining.
sm_mapvote_startround	Mapchooser	2	Specifies when to start the vote based on rounds remaining. Use 0 on TF2 to start vote during bonus round time.
sm_mapvote_startfrags	Mapchooser	5	Specifies when to start the vote base on frags remaining.
sm_extendmap_timestep	Mapchooser	15	Specifies how much many more minutes each extension makes.
sm_extendmap_roundstep	Mapchooser	5	Specifies how many more rounds each extension makes.
sm_extendmap_fragstep	Mapchooser	10	Specifies how many more frags are allowed when map is extended.
sm_mapvote_exclude	Mapchooser	5	Specifies how many past maps to exclude from the vote.
sm_mapvote_include	Mapchooser	5	Specifies how many maps to include in the vote.
sm_mapvote_novote	Mapchooser	1	Specifies whether or not MapChooser should pick a map if no votes are received.
sm_mapvote_extend	Mapchooser	0	Number of extensions allowed each map.
sm_mapvote_dontchange	Mapchooser	1	Specifies if a 'Don't Change' option should be added to early votes (like rockthevote).
sm_mapvote_voteduration	Mapchooser	20	Specifies how long the mapvote should be available for.
sm_mapvote_runoff	Mapchooser	0	New in 1.5 - Hold run of votes if winning choice is less than a certain margin
sm_mapvote_runoffpercent	Mapchooser	50	New in 1.5 - If winning choice has less than this percent of votes, hold a runoff
sm_nominate_excludecurrent	Nominations	1	Specifies if the MapChooser excluded maps should also be excluded from Nominations.
sm_nominate_excludeold	Nominations	1	Specifies if the current map should be excluded from the Nominations list.
sm_rtv_needed	Rockthevote	0.60	Percentage of players needed to rockthevote.
sm_rtv_minplayers	Rockthevote	0	Number of players required before RTV will be enabled.
sm_rtv_initialdelay	Rockthevote	30.0	Time (in seconds) before first RTV can be held.
sm_rtv_interval	Rockthevote	240.0	Time (in seconds) after a failed RTV before another can be held.
sm_rtv_changetime	Rockthevote	0	When to change the map after a successful RTV: 0 - Instant, 1 - RoundEnd, 2 - MapEnd.
sm_rtv_postvoteaction	Rockthevote	0	What to do with RTV's after a mapvote has completed. 0 - Allow, success = instant change, 1 - Deny
sm_randomcycle_exclude	Randomcycle	5	Specifies how many past maps to exclude from the Randomcycle maplist.

Admin Commands

Command	Plugin	Access	Format	Description
sm_mapvote	Mapchooser	changemap		Forces MapChooser to attempt to run a map vote now.
sm_setnextmap	Mapchooser	changemap	<map>	Sets the nextmap and disables the end of map vote for this map.
sm_nominate_addmap	Nominations	changemap	<map>	Forcibly adds the map to the list of nominations (even if the limit had been reached).
sm_maphistory	Nextmap	changemap		Shows the most recent maps played.

Public Commands

Command	Plugin	Format	Description
sm_nominate	Nominations	<map> or none for menu	Attempts to nominate a map for the next vote.
say nominate	Nominations		Shows a list of possible maps to nominate.
say rtv	Rockthevote		Votes to Rockthevote.
sm_rtv	Rockthevote		Votes to Rockthevote.
listmaps	Nextmap		Lists the current mapcycle in console.

Tips and Tricks

• The nextmap output from the basetriggers plugin will display 'Pending Vote' if mapchooser is running, has end of map votes enabled and the vote has not yet run this map. Remove the plugin or disable end of map votes to see the actual map displayed.