Module Player Limits - Steell/Ultimate-Mapchooser GitHub Wiki

The Player Limits module extends Ultimate Mapchooser's exclusion system to allow users to specify, in their UMC-Mapcycle definitions, a range of players to be on the server for a map is available. Specifically, it defines two new group options default_min_players and default_max_player, and two new map options min_players and max_players.

"umc_mapcycle"
{
    "A Group"
    {
        "default_min_players"  "X"
        "default_max_players"  "X"
        ...

        "A Map"
        {
            "min_players"  "X"
            "max_players"  "X"
            ...
        }
    }
    ...
}

Where X is the number of players on the server. The group options specify the defaults for all the maps in the group, in the event that the maps do not define their own min_players and max_players options.

The list of cvars for the Time Limits module is located in cfg/sourcemod/umc-timelimits.cfg.

###Example

"umc_mapcycle"
{
    "GroupA"
    {
        "default_min_players"  "0"
        "default_max_players"  "12"

        "MapAA"
        {
        }

        "MapBA"
        {
        }
    }

    "GroupB"
    {
        "default_min_players"  "13"
        "default_max_players"  "24"

        "MapAB"
        {
            "max_players"  "18"
        }

        "MapBB"
        {
        }
    }
}

This example defines two Map Groups, "GroupA" and "GroupB", and two maps in each group. "GroupA" has the options default_min_players and default_max_players set so that all its maps are by default available if the server has between 0 and 12 players (inclusive). Since none of it's maps specify min_players or max_players, these defaults are not overridden and are used by both maps.

In "GroupB", default_min_players and default_max_players are set so that the group is available between 13 and 14 players (inclusive). "MapAB" has defined a max_players of 18, thus making it's player count range 13 to 18 players. "MapBB" does not specify it's own min_players or max_players, so it will use the defaults for "GroupB."