How to install mods onto your Insurgency Sandstorm server
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