MapChooser

MapChooser

A powerful and customizable map voting system for SwiftlyS2.

Overview

MapChooser is a map voting plugin for SwiftlyS2. It handles Rock The Vote (RTV), map nominations, and manual voting. It also triggers an automated vote at the end of the map based on time or rounds played.

Commands

Configuration (config.jsonc)

RTV Settings (Rtv)

Votemap Settings (Votemap)

End Of Map Settings (EndOfMap)

Extend Map Settings (ExtendMap)

Global Settings

Commands Settings (Commands)

All command aliases are fully configurable. Each setting accepts a comma-separated list of aliases.

Map Configuration

Each map entry supports the following properties:

Note: Maps without MinPlayers/MaxPlayers (or set to 0) are considered valid for any number of players. If you want a map to only appear when there are few players, you must also set MinPlayers on your other maps to exclude them at low player counts. Bots are not counted.

Example

{
    "MapChooserMaps": {
        "Maps": [
            {
                "Name": "Dust II",
                "Id": "de_dust2",
                "MinPlayers": 4
            },
            {
                "Name": "Inferno Night",
                "Id": "3124567099",
                "MinPlayers": 4
            },
            {
                "Name": "Mirage",
                "Id": "de_mirage",
                "MinPlayers": 1,
                "MaxPlayers": 3
            },
            {
                "Name": "Overpass",
                "Id": "de_overpass",
                "MinPlayers": 1,
                "MaxPlayers": 3
            }
        ]
    }
}

In this example, when there are 1–3 real players on the server, only Mirage and Overpass will appear in votes and nominations. Once there are 4+ players, only Dust II and Inferno Night will be available.

Map Cycle

When a match ends and no end-of-map vote fires, the plugin automatically advances to the next map in the cycle. The cycle order follows maps.jsonc. Use !cyclemenu to view the order, move maps up/down, or remove them in-game. Use !addmap / !removemap to manage the list from chat — changes persist to disk immediately.

Features

• Live Vote Updates: Menus refresh in real-time as players cast their votes.
• Smart Triggers: Automated votes trigger based on time remaining, rounds remaining, or when a team is close to winning.
• Map Cooldown: Prevents recently played maps from appearing in the vote too soon.
• Map Extension: Players can vote to extend the current map time or round limit.
• Spectator Control: Configurable option to allow or disallow spectators from voting.
• Vote Removal: Players can change their mind and remove their RTV vote with !unrtv.
• Workshop Support: Seamlessly change to workshop maps using their IDs.
• Localized: Full translation support via JSONC files.

Installation

1. Download the latest release or build the plugin yourself.
2. Copy the published plugin folder to your server: .../game/csgo/addons/swiftlys2/plugins/MapChooser/
3. Ensure the plugin has its resources/ folder alongside the DLL.
4. Start/restart the server.

Building

• Open the project in your preferred .NET IDE (e.g., VS Code, Visual Studio).
• Build the project. The output DLL and resources will be placed in the build/ directory.