Purpose

The Admin Menu module adds various Ultimate Mapchooser abilities to the SourceMod Admin Menu. Specifically, it gives admins the ability to change the current map, set the next map, and run a map vote. This module is a good starting point for configuring Utimate Mapchooser because it gives administrators the ability to quickly test various settings, as well as their UMC-Mapcycle. Simply put, its solely for administrative purposes for server admins and adds a menu specifically for UMC under the sm_admin menus. No other features are added that are public/player facing.

List of CVars

// Flags required for admins to be able to manually select settings for the vote. If the admin does not have the proper priveleges, the vote will automatically use the cvars in this file. If empty, all admins have access.
// -
// Default: ""
sm_umc_am_adminflags_default "z"

// Flags required for admins to be able to select maps which would normally be excluded by UMC. If empty, all admins can select excluded maps.
// -
// Default: ""
sm_umc_am_adminflags_exclude ""

// Allows a map to appear in the vote more than once. This should be enabled if you want the same map in different categories to be distinct.
// -
// Default: "1"
// Minimum: "0.000000"
// Maximum: "1.000000"
sm_umc_am_allowduplicates "0"

// File to use for Ultimate Mapchooser's map rotation.
// -
// Default: "umc_mapcycle.txt"
sm_umc_am_cyclefile "umc_mapcycle.txt"

// Adds a "Don't Change" option to votes.
// -
// Default: "1"
// Minimum: "0.000000"
// Maximum: "1.000000"
sm_umc_am_dontchange "1"

// Specifies how long a vote should be available for.
// -
// Default: "20"
// Minimum: "10.000000"
sm_umc_am_duration "20"

// Sound file (relative to sound folder) to play at the completion of a vote.
// -
// Default: ""
sm_umc_am_endsound ""

// Adds an "Extend" option to votes.
// -
// Default: "0"
// Minimum: "0.000000"
// Maximum: "1.000000"
sm_umc_am_extend "0"

// Specifies how many more frags each extension adds to the frag limit.
// -
// Default: "10"
// Minimum: "1.000000"
sm_umc_am_extend_fragstep "10"

// Specifies how many more rounds each extension adds to the round limit.
// -
// Default: "5"
// Minimum: "1.000000"
sm_umc_am_extend_roundstep "5"

// Specifies how many more minutes each extension adds to the time limit.
// -
// Default: "15"
// Minimum: "1.000000"
sm_umc_am_extend_timestep "15"

// Specifies what action to take if the vote doesn't reach the set theshold.
//  0 - Do Nothing,
//  1 - Perform Runoff Vote
// -
// Default: "0"
// Minimum: "0.000000"
// Maximum: "1.000000"
sm_umc_am_failaction "0"

// Specifies how many past map groups to exclude from votes.
// -
// Default: "0"
// Minimum: "0.000000"
// Maximum: "10.000000"
sm_umc_am_groupexclude "0"

// Specifies how many past maps to exclude from votes. 1 = Current Map Only
// -
// Default: "4"
// Minimum: "0.000000"
// Maximum: "10.000000"
sm_umc_am_mapexclude "4"

// Specifies whether vote menu items are displayed in a random order.
// -
// Default: "0"
// Minimum: "0.000000"
// Maximum: "1.000000"
sm_umc_am_menuscrambled "0"

// Specifies whether the number of nominated maps appearing in the vote for a map group should be limited by the group's "maps_invote" setting.
// -
// Default: "0"
// Minimum: "0.000000"
// Maximum: "1.000000"
sm_umc_am_nominate_strict "0"

// Specifies what action to take if the runoff vote reaches the maximum amount of runoffs and the set threshold has not been reached.
//  0 - Do Nothing,
//  1 - Change Map to Winner
// -
// Default: "0"
// Minimum: "0.000000"
// Maximum: "1.000000"
sm_umc_am_runoff_failaction "0"

// Specifies the maximum number of maps to appear in a runoff vote.
//  1 or 0 sets no maximum.
// -
// Default: "0"
// Minimum: "0.000000"
sm_umc_am_runoff_max "0"

// If specified, this sound file (relative to sound folder) will be played at the beginning of a runoff vote. If not specified, it will use the normal vote start sound.
// -
// Default: ""
sm_umc_am_runoff_sound ""

// Specifies a maximum number of runoff votes to run for a vote.
//  0 = unlimited.
// -
// Default: "0"
// Minimum: "0.000000"
sm_umc_am_runoffs "0"

// Sound file (relative to sound folder) to play at the start of a vote.
// -
// Default: ""
sm_umc_am_startsound ""

// If the winning option has less than this percentage of total votes, a vote will fail and the action specified in "sm_umc_vc_failaction" cvar will be performed.
// -
// Default: "0"
// Minimum: "0.000000"
// Maximum: "1.000000"
sm_umc_am_threshold "0"

// Specifies which admin flags are necessary for a player to participate in a vote. If empty, all players can participate.
// -
// Default: ""
sm_umc_am_vote_adminflags ""