Skip to content

Managing Maps and Map Pools

Complete guide to managing maps and creating custom map pools for your tournaments.

Overview

The Maps & Map Pools page allows you to:

  • ✅ Automatic map import - Latest maps imported on first start
  • ✅ Add custom maps with images
  • ✅ Create reusable map pools
  • ✅ Select map pools during tournament creation
  • ✅ Use the default Active Duty pool (7 competitive maps)

Access: Navigate to Maps in the sidebar

Automatic Map Import

The system automatically imports the latest CS2 maps when you first start the project or when the maps table is empty.

How It Works

On First Start: - When you start the API for the first time, the system detects an empty maps table - Automatically fetches all available maps from the CS2 Server Manager repository - Imports all maps with de_, cs_, and ar_ prefixes - Creates map pools automatically: - Active Duty - Competitive maps (default) - Defusal only - All defusal maps (de_ prefix) - Hostage only - All hostage maps (cs_ prefix) - Arms Race only - All arms race maps (ar_ prefix)

After Clearing Maps: - If you delete all maps and restart the API, the system will automatically re-import maps - This ensures you always have the latest maps available

Map Naming

Maps are automatically named based on their file names: - Prefixes (de_, cs_, ar_) are removed - Underscores (_) are converted to spaces - First letter of each word is capitalized - Special cases handled (e.g., de_dust2 → "Dust II")

Examples: - de_ancient → "Ancient" - de_dust2 → "Dust II" - cs_office → "Office" - ar_shoots → "Shoots"

Fallback Behavior

If the GitHub repository is unavailable: - System falls back to a hardcoded list of common maps - Ensures the system always has maps available even without internet access

Maps Tab

Viewing Maps

The Maps tab displays all available maps in your system:

  • Map Cards - Visual cards showing map image (if available) and display name
  • Map ID - Internal identifier (e.g., de_dust2, de_mirage)
  • Display Name - User-friendly name (e.g., "Dust II", "Mirage")

Adding a New Map

  1. Click "Add Map" button (top right)
  2. Fill in the form:

Map ID (required): - Lowercase letters, numbers, and underscores only - Example: de_dust2, cs_italy, de_mirage - Cannot be changed after creation

Display Name (required): - User-friendly name shown in UI - Example: "Dust II", "Mirage", "Ancient"

Map Image (optional): - Upload PNG, JPG, GIF, or WebP (max 5MB) - Or click "Fetch from GitHub" to auto-download from sivert-io/cs2-server-manager - Preview shown before saving

  1. Click "Create"

Editing a Map

  1. Click on any map card
  2. Click "Edit" in the actions modal
  3. Modify display name or image
  4. Click "Update"

Note: Map ID cannot be changed after creation

Deleting a Map

  1. Click on the map card
  2. Click "Delete" in the actions modal
  3. Confirm deletion

Warning: Deleting a map removes it from all map pools that use it

Map Pools Tab

Viewing Map Pools

The Map Pools tab shows:

  • Default Pool - Active Duty pool (7 competitive maps) - marked with "Default" chip
  • Automatic Pools - Created automatically based on map types:
  • Defusal only - All defusal maps (de_ prefix)
  • Hostage only - All hostage maps (cs_ prefix)
  • Arms Race only - All arms race maps (ar_ prefix)
  • Custom Pools - Your created pools showing:
  • Pool name
  • Number of maps
  • First 5 maps as chips (+X more if applicable)

Creating a Map Pool

  1. Switch to "Map Pools" tab
  2. Click "Create Map Pool" button
  3. Fill in:

Map Pool Name (required): - Example: "My Custom Pool", "Aim Maps Only", "All Maps"

Select Maps (required, at least 1): - Use the autocomplete dropdown - Type map name or select from list - Selected maps appear as chips - Click "Add all" to select every available map

  1. Click "Create"

Editing a Map Pool

  1. Click on any map pool card
  2. Click "Edit" in the actions modal
  3. Modify name or map selection
  4. Click "Update"

Deleting a Map Pool

  1. Click on the map pool card
  2. Click "Delete" in the actions modal
  3. Confirm deletion

Using Map Pools in Tournaments

During Tournament Creation

When creating a tournament with BO1, BO3, or BO5 format:

  1. Navigate to Step 3: Map Pool
  2. Select from dropdown:

Options: - Active Duty - Default 7 competitive maps (recommended for veto) - Your Custom Pools - Any pools you've created - Custom - Manually select maps for this tournament

  1. If selecting Custom:
  2. Use autocomplete to choose maps
  3. Click "Add All" to select all available maps
  4. Click "Save Map Pool" to create a new pool from your selection

Map Pool Requirements

For Veto Formats (BO1/BO3/BO5): - ⚠️ Exactly 7 maps required for proper veto flow - System shows warning if pool has ≠ 7 maps - Active Duty pool automatically has 7 maps

For Round Robin/Swiss: - Any number of maps allowed - Maps rotate automatically

Map Pool Selection Tips

Best Practices:

  • ✅ Use Active Duty for standard competitive tournaments
  • ✅ Create custom pools for specific map sets (e.g., "Aim Maps", "Old School")
  • ✅ Save frequently used combinations as pools
  • ✅ Name pools descriptively (e.g., "7 Map Competitive", "5 Map Pool")

Map Images

Automatic Image Fetching

When creating a map, you can fetch images automatically:

  1. Enter Map ID (e.g., de_dust2)
  2. Click "Fetch from GitHub"
  3. System downloads from sivert-io/cs2-server-manager
  4. Image preview appears if found

Manual Image Upload

  1. Click "Upload Image"
  2. Select PNG, JPG, GIF, or WebP file
  3. Max size: 5MB
  4. Preview shown before saving

Image Display

  • Maps show image in cards (if available)
  • Placeholder icon shown if no image
  • Images used in map veto interface
  • Images displayed on team match pages

Default Map Pools

Active Duty Pool

The Active Duty pool includes 7 competitive maps:

  1. Ancient
  2. Anubis
  3. Dust II
  4. Inferno
  5. Mirage
  6. Nuke
  7. Vertigo

This pool is: - ✅ Always available - ✅ Pre-configured with 7 maps - ✅ Recommended for BO1/BO3/BO5 tournaments - ✅ Marked as default pool - ✅ Cannot be edited or deleted

Automatic Type-Based Pools

The system automatically creates pools based on map types:

Defusal only Pool: - Contains all maps with de_ prefix (defusal maps) - Automatically updated when new defusal maps are imported - Useful for defusal-only tournaments

Hostage only Pool: - Contains all maps with cs_ prefix (hostage rescue maps) - Automatically updated when new hostage maps are imported - Useful for hostage rescue tournaments

Arms Race only Pool: - Contains all maps with ar_ prefix (arms race maps) - Automatically updated when new arms race maps are imported - Useful for arms race tournaments

These pools are: - ✅ Created automatically on first start - ✅ Updated when maps are re-imported - ✅ Can be edited or deleted (will be recreated on next import)

Troubleshooting

Map Pool Has Wrong Number of Maps

For Veto Formats: - System requires exactly 7 maps - Warning shown if pool has ≠ 7 maps - Create new pool with 7 maps or use Active Duty

Map Image Not Showing

  • Check image URL is valid
  • Try re-uploading image
  • Use "Fetch from GitHub" for standard maps
  • Ensure file is < 5MB

Can't Delete Map

  • Map may be in use by active tournament
  • Remove from all map pools first
  • Check if map is in default Active Duty pool (cannot remove)

Map Pool Not Appearing in Tournament

  • Ensure map pool has at least 1 map
  • Check tournament format supports map pools
  • Verify map pool wasn't deleted

Next Steps