[Nefarius]

Workshop Map Loader
Advanced Workshop Map Loader and Game Type Adjuster

Description
This plugin searches for workshop maps in your servers map directory and assists the admin in handling those. It will also ensure that the current game mode will get automatically adjusted, if requested by the admin.

The plugin was developed for CS:GO and will not work in other games.

Features

Admin menu
The Top-Level menu is dynamically built depending on your servers' workshop maps and their community tags:



Each category hosts the corresponding map:



Note, that a map may appear in multiple categories depending of it's tags.

Vote menu
It's possible to interact with the stock MapChooser plugin or the MapChooser Extended plugin.



Commands

• sm_wml brings up the map list (for Admins with at least changemap-Permissions)
• sm_wml_reload refreshes the map list (useful to be triggered by the admin after the server has downloaded new workshop maps)
• sm_wml_vote_now requests an instant next map vote
• sm_wml_nominate_random_maps will nominate a given amount of random maps from the database for the next vote. It's behavior is controlled by the sm_wml_nominate_* Cvars.

Snippet for your adminmenu_custom.txt:

	"ServerCommands"
	{
		"Load Workshop Map"
		{
			"cmd"		"sm_wml"
			"admin"		"sm_changemap"
		}
		"Refresh Workshop Map List"
		{
			"cmd"		"sm_wml_reload"
			"admin"		"sm_changemap"
		}
		"Start Next Workshop Map Vote"
		{
			"cmd"		"sm_wml_vote_now"
			"admin"		"sm_changemap"
		}
	}

Cvars
This plugin generates it's config file in csgo/cfg/sourcemod/wml.cfg after first load.

• sm_wml_version returns current plugin version
• sm_wml_changemode will change the game mode corresponding to the selected category <1 = Enabled/Default, 0 = Disabled>
• sm_wml_autoreload defines if the database content should be refreshed on plugin reload. It's recommended to turn it off after the first successful load for performance reasons <1 = Enabled/Default, 0 = Disabled>
• sm_wml_armsrace_weapon defines the weapon in Armsrace mode where voting shall pop up if the first player acquired it <awp = Default>
• sm_wml_nominate_all_maps defines if all maps shall be allowed to get into vote nomination rather than only maps matching the current game mode (e.g. in Casual there won't be Armsrace maps nominated) <1 = Enabled, 0 = Disabled/Default>
• sm_wml_override_mapcycle creates and sets a custom mapcycle file on each mapchange with workshop maps matching the current game mode. This will allow excellent automated interaction with stock map management plugins <1 = Enabled/Default, 0 = Disabled>

Translations

• English
• German
• Russian
• Romanian

Plans/TODOs
Suggestions welcome!

• More translations
• Add map blacklist to exclude "broken" map IDs

Changelog

Spoiler

2014-02-16
* Moved developer notes and changelog to Github

2014-01-11

* Sorting works again
* No API key needed

2014-01-09

* Fixed memory leaks in menus
* Implemented map change listener
* Implemented API Key validation
* Fixed plugin version cvar showing up in config file

2014-01-08 (v0.1.0)

* Top-Level Map Category Menu implemented
* Fetching additional map info from SteamWorks online implemented

2014-01-06 (v0.0.2)

* Fixed "Unknown command: sm_wml_reload" client error message

2014-01-06 (v0.0.1)

* Initial release.

Upgrading
If you are upgrading from a version pre-0.3.x please process the following steps:

• Remove directory sourcemod/data/sm_wml
• Empty directory sourcemod/data/wml
• Remove file cfg/sourcemod/sm_wml.cfg

If you have at least version 0.5.0 installed you can auto-update this plugin with the Updater plugin.

Optional Dependencies

• If you haven't already, take a peek at the Updater so the plugin will be updated automatically. (recommended)
• I recommend using it with MapChooser Extended if you like to utilize advanced voting.
• You also might have a look at my Server Hibernate Fix plugin to avoid locking up your server on hibernation.

Installation/Requirements

1. You should have at least SourceMod v1.5.3
2. Your server must be running at least one of the following extensions:
   • cURL (recommended)
   • System2
3. Write-Permissions to sourcemod/data directory.
4. Write-Permissions to sourcemod/data/sqlite directory.
5. Download latest archive from Github using the download link below.
6. Extract the contents of WorkshopMapLoader-master into your servers csgo/addons/sourcemod directory.
7. Restart your server or load the plugin by hand.
8. Adjust the configuration file to your needs or just go with the defaults.
9. Leave feedback!

Download latest ZIP archive with all necessary files
...or head over to the project site for more information

Important: this plugin can't be compiled on the Forum, please use the provided download link to get the ready-to-use plugin or source code to compile by yourself.

Demonstration

A small unspectacular demo video showing WML doing it's job: