Insurgency: Sandstorm Mods, Map Cycle and Scenarios via mod.io
Insurgency: Sandstorm mods come from mod.io. To run them on a server you list the mods in the Mods (mod.io) field on the Startup tab, give the server a mod.io account, and subscribe that account to the mods you want. Custom maps need a vanilla start scenario plus the Mod map and Mod scenario fields. Your rotation is controlled by Map cycle (MapCycle.txt) on the Configs tab.
Warning before you copy any older guide: the mod.io authentication changed with update 1.20 ("Operation: Clear Sight"). Several host guides describe a new method, while the developers' Server Admin Guide still documents the older one, so this page covers both and says which is which. Checked November 2026.
- Mods need a dedicated mod.io account for the server. On the panel, set the mods in Mods (mod.io) and the server's token in mod.io token on the Startup tab, then Save startup and Restart.
- After 1.20, hosts describe a one-time emailed security code and mods controlled by the server account's subscriptions. The older flow (an access token in an ini file plus
Mods.txt) is still in the developers' guide, but host documentation says it no longer works. The security code has no Startup field, so contact support to apply it. - Custom maps: keep a vanilla Start scenario and fill in Mod map and Mod scenario (the game's
-ModDownloadTravelTo=MAP?Scenario=SCENARIO), using names from the mod's mod.io page. - Map cycle (MapCycle.txt) takes one scenario per line, with optional
ModeandLightingvalues (some host guides also showMaxPlayers).
On this page
Which mod.io method does your server use?
The developers' Server Admin Guide describes this older flow: create a read-only mod.io API access token, put it in Engine.ini under [/Script/ModKit.ModIOClient] (bHasUserAcceptedTerms=True and AccessToken=...), enable mods, then list mod IDs one per line in Mods.txt, or use -ModList= or -CmdModList="id1,id2". The guide shows no update date. On the panel, Engine.ini and Mods.txt are both on the Configs tab (Engine.ini is stop first), and the token and mod IDs also have Startup fields (mod.io token, Mods (mod.io)).
Host documentation written after update 1.20 says the older approach no longer works. Two sources say the token in the ini file and Mods.txt or -ModList no longer apply, and describe the new flow as requiring a fresh mod.io account. One host guide still has you paste a token into GameUserSettings.ini on top of the new steps, but a community server project's notes (updated September 2026) say that token does nothing since 1.20. Follow the newer steps below; they are the only method we found documented as working on 1.20 and later. Whichever you use, test with one mod before adding twenty.
Setting up server mods after update 1.20
- Create a separate mod.io account
Use a new account and email address just for the server. Do not reuse your player account, since hosts report that a shared account will not download mods.
- Subscribe to the mods
Log in to mod.io as the server account and subscribe to every map, mutator and mod you want. Per the host guides, those subscriptions decide what the server downloads. Also list the mod IDs in Mods (mod.io) on the Startup tab and click Save startup.
- Get a security code
Request the one-time security code for that account. The 5-digit code arrives by email.
- Ask support to apply the code
The game takes the code as
-SecurityCode=CODEon its launch line, which is staff-only on the panel. Contact support with the code and ask them to apply it. Once the server has started fully, it can be stopped again. - Have the code set back to none
The code is single use. Ask support to change it to
none(or remove it), then click Restart. The server should now download the subscribed mods. - Check the files
Open the Files tab: downloaded mods appear under a
mod.io/254folder (254 appears to be the game's mod.io ID). If downloads loop, hosts suggest deleting that cache and authorizing again with a new code (ask support to apply it).
Players also need the same maps and mods. Custom maps require each player to subscribe on their own mod.io account to join.
Hosting with ChicagoServers? The Insurgency Sandstorm server hosting page lists what is included, such as free server backups and SFTP file access. The principles above still apply.
Custom maps with Mod map and Mod scenario
A modded map cannot be your boot map, because it has not downloaded when the server starts. The server boots on a vanilla map, downloads the mods, and then travels to the custom map. On the panel, leave Start scenario on a vanilla scenario and fill in Mod map and Mod scenario on the Startup tab; together they are the game's -ModDownloadTravelTo. Without that travel step, one project notes that mutators on the first map show as invalid.
-ModDownloadTravelTo=TORO?Scenario=Scenario_TORO_Checkpoint_SecurityTORO is a community map whose ID (94277) is used as the example in the LinuxGSM docs. Add the map's scenarios to your Map cycle (MapCycle.txt) so it stays in rotation, and enter whatever mutators the mod lists in Mutators (comma-separated names, like the game's -mutators=Name1,Name2). Click Save startup, then Restart.
Writing MapCycle.txt
Open the Configs tab and pick Map cycle (MapCycle.txt) (the file is Insurgency/Config/Server/MapCycle.txt). Put one scenario per line. The server cycles in order. Without the file, the default is all Versus scenarios. Each line can carry a mode override and a lighting value (host guides also show a per-entry MaxPlayers, which the developers' guide does not document). Click Save, then Restart:
(Scenario="Scenario_Crossing_Checkpoint_Security",MaxPlayers=8)
(Scenario="Scenario_Town_Checkpoint_Security",Mode="CheckpointHardcore")
(Scenario="Scenario_Town_Checkpoint_Security",Lighting="Night")
(Scenario="Scenario_Refinery_Push_Security",Lighting="Day")- List Day and Night entries separately for the same scenario if you want the correct voting images.
Mode="CheckpointHardcore"is the only mode override value shown in the developers' guide.bUseMapCycleandbMapVotinginGame.iniboth default to True. Voting picks from the cycle.- The game can load a different cycle file with
-MapCycle=Name, but that is a staff-only launch option on the panel; use the file the Configs tab lists. - The developers' guide itself uses both Hideout and Town for one map (in its tables versus its examples), so verify names with the
scenarioscommand on the Console tab.
Game modes and finding the right scenario names
Scenario names follow the pattern Scenario_MAP_TYPE with an optional side or layout (_Security, _Insurgents, _East, _West, _A). The most reliable way to get names for your build is the Console tab: type maps to list levels and scenarios to list scenarios (each with an optional filter), and click Send. You can even switch with travelscenario SCENARIO.
| Group | Modes | Notes |
|---|---|---|
| Co-op (vs. AI) | Checkpoint, Outpost, Survival | Hardcore Checkpoint variant; players all on Security in Outpost and Survival |
| Versus (PvP) | Push, Firefight, Frontline, Domination, Ambush, Defusal | Skirmish and Team Deathmatch also appear in the developers' scenario tables |
The developers' guide lists Crossing, Farmhouse, Hideout, Hillside, Ministry, Outskirts, Precinct, Refinery, Summit, Power Plant, Tideway, Bab and Citadel with their available scenarios. Not every map has every mode (for example, Bab and Citadel list Outpost, and only some maps list Survival). Modes are added and removed over time (Wikipedia's article on the game notes Skirmish was removed from matchmaking in an older update), so confirm with scenarios on your own server before building a cycle.
Common problems
- Only stock maps in the vote. The map's scenarios are not in Map cycle (MapCycle.txt), or the mod did not finish downloading.
- Server stuck downloading. Wait for the first download, and if it loops, delete the mod.io cache on the Files tab and ask support to re-authorize with a new code. A community post warns that copying the mod.io folder to another machine causes a download loop.
- Mutators show as invalid. Keep a vanilla Start scenario and use Mod map and Mod scenario.
- Security code already redeemed. The server is authorized. Ask support to set the code to
none. - Player cannot join. They have not subscribed to the same map or mods on their mod.io account.
- Server will not start after a mod change. Undo the last mod you added and check the Troubleshoot tab and the last lines on the Console tab.
Frequently asked questions
How do I add mods to an Insurgency: Sandstorm server?
Give the server its own mod.io account, subscribe that account to the mods, list the mod IDs in Mods (mod.io) on the Startup tab, and have the one-time emailed security code applied (contact support for that step). Older guides use an access token and Mods.txt instead.
What are Mod map and Mod scenario?
Startup fields for modded maps, matching the game's -ModDownloadTravelTo. The server boots on a vanilla map, downloads mods, then travels to the map and scenario you give, in the form MAP?Scenario=SCENARIO.
Does Mods.txt still work?
The developers' guide documents it and the panel lists it on the Configs tab, but host guides written after update 1.20 say it no longer applies. Subscribe the server's mod.io account to the mods instead, and test with one mod first.
Where is MapCycle.txt?
On the Configs tab as Map cycle (MapCycle.txt); on disk it is in Insurgency/Config/Server/. It takes one scenario per line, with optional Mode and Lighting values. Some host guides also show a per-entry MaxPlayers value.