How to Download Mods for Insurgency: Sandstorm

In the 1.6 update for Insurgency: Sandstorm, the game developers introduced the ability to download mods. Mods for Insurgency: Sandstorm are hosted on the site Mod.io, which is a cross platform multi-game site for downloading and managing mod content.

** ENSURE YOUR SERVER IS STOPPED PRIOR TO MAKING ANY CONFIG FILE CHANGES! **

Log into the Mod.io Site

You will need to log into Mod.io to enable mod downloads on your Insurgency: Sandstorm server. If you have an account on any of the following services, you can use your login information from these services to log into Mod.io (instead of creating a new account). If not, you can create a new account directly on Mod.io for free.

Generate Token on Mod.io Site

Once logged into Mod.io, click your username in the upper right corner to access your profile page. Select "API Access" from the left-hand menu.

In the "OAuth 2 Management" section, enter a name for the token. You can use something descriptive like "Insurgency training server". Each server should have its own token. Click the "Create Token" button to generate the token. Once created, the token will be displayed—remember, these tokens should be treated like passwords and kept secret!

Setting Startup Arguments on Your ChicagoServers Insurgency: Sandstorm Server

To enable mods, you must set certain "Startup Arguments" on your server. In the ChicagoServers control panel, navigate to the Commandline Manager to create or edit a custom commandline.

Add the following Startup Argument to enable mod downloads:

-mods

Edit GameUserSettings.ini Config File

Add the following settings to the GameUserSettings.ini config file to allow your server to connect to Mod.io and download mods automatically:

[/Script/ModKit.ModIOClient]
bHasUserAcceptedTerms=True
AccessToken=TOKEN HERE

Browse for Mods on Mod.io

Visit the Mod.io site, click on "Games," and select "Insurgency: Sandstorm" to browse available mods. Copy the mod ID numbers for the mods you want to use.

Create Mods.txt File

Create a file called Mods.txt in /Insurgency/Config/Server and list each mod ID on a separate line:

Alternate Method: Command Line Arguments

Alternatively, you can add the mod list directly to the startup arguments:

-CmdModList="mod1,mod2,mod3"

Add "Mutators" in Startup Arguments (If Required)

If a mod requires a "Mutator," add the appropriate Startup Argument:

-mutators=(mutator name)

Some Mods Require a "changelevel" Command

If a mod needs a "changelevel" command to take effect, you can automate this by adding the following setting:

-ModDownloadTravelTo=travel URL