A map cycle tells your Insurgency: Sandstorm server which scenarios to rotate through automatically once a match ends, instead of replaying the same map every time. This guide covers creating a MapCycle.txt file, the two formats it supports, and how to point your server at it.
Step 1: Create MapCycle.txt
- Log into your MintServers panel and click the Stop button to shut down your server before editing.
- Navigate to the Files tab on the left-hand sidebar.
- Browse into your
Insurgencyfolder. As with Admins.txt, theConfigandServerfolders inside it usually don't exist by default, so you may need to create them yourself. - Inside
Insurgency/Config/Server, create a new file named exactlyMapCycle.txt.
📁 Insurgency (or your main server directory)
📁 Config
📁 Server
📄 Admins.txt (covered in our admins guide)
Step 2: Choose Your Format
MapCycle.txt supports two formats. Use whichever fits what you need, and don't mix them in the same file.
Just the scenario name on each line, with no blank lines in between. This is all you need if you're not setting per-scenario options like a player cap or lighting.
Scenario— required. The scenario to load, same names as the simple format.MaxPlayers— optional. Caps player count for that specific rotation entry.Mode— optional. Lets you load a variant likeCheckpointHardcoreinstead of the standard mode.Lighting— optional. Accepts"Day"or"Night"on maps that support it.
Step 3: Point Your Server At The File
To load your MapCycle.txt on startup, add the following to the Additional Switches field on your Game Settings tab:
Save your changes and start your server. As with -AdminList=, leave off the .txt extension, and the value is case-sensitive.
Understanding Scenario Names
Scenario names generally follow the pattern Scenario_, though there are two exceptions: Team Deathmatch scenarios end in _Team_Deathmatch with no faction, and Skirmish scenarios have no faction segment at all since it's a free-for-all mode. The map segment isn't always the map's display name, some maps use an internal alias instead:
- Bab
- Crossing (Canyon)
- Farmhouse
- Hideout (Town)
- Hillside (Sinjar)
- Ministry
- Outskirts (Compound)
- Power Plant (PowerPlant)
- Precinct
- Refinery (Oilfield)
- Summit (Mountain)
- Tell
- Tideway (Buhriz)
This internal name only matters for the Map/starting scenario field, not the scenario name itself, for example, Crossing's scenarios are still written as Scenario_Crossing_.... Not every mode is available on every map. For the complete, up-to-date list of every scenario name, check the official mod.io Server Admin Guide.
🛠️ Troubleshooting Common Issues
Server ignores the map cycle entirely:Double-check the-MapCycle=value in Additional Switches matches your file's name exactly (minus .txt) and that the file is inInsurgency/Config/Server.Cycle stops partway through:Look for a blank line or stray character breaking the file partway down. Remove it and restart.A scenario won't load:Confirm the spelling matches exactly, including capitalization, and that the mode you're requesting actually exists for that map.Mixing formats causes errors:Stick to either all simple entries or all extended entries in one file rather than combining both styles.
Once your map cycle is saved and your server has restarted, it'll rotate through your chosen scenarios automatically after each match. If you run into any trouble getting the format right, no worries! Just open a support ticket and our team will gladly help you sort it out.