Skip to main content

How to Install Custom Mod Map on Your Insurgency Sandstorm Server

Note:

The Startup tab only dictates the very first map your server loads when you click Start. To ensure your custom maps and mutators stay active after the first match ends, you must also add your scenarios to your MapCycle.txt file. If you skip this step, your mods will disappear from the voting screen, and the server will revert to vanilla maps!

1. Log In to Your Panel

2. Stop Your Server

3. Go to Insurgency: Sandstorm on Mod.io

4. Select API Access

Step 1 points to the user profile icon at the bottom left of the screen, and Step 2 points to the 'API Access' option located under the 'My Account' settings menu that appears

5. Generate Access Token

Scroll down to OAuth 2 Management

Arrow points down to a text input field labeled 'Client name' within the 'OAuth Access' section

Generate Access Token

Step 1 points to the 'Token name' input field where 'Cybrancee' has been entered; Step 2 points to a dropdown menu where the 'Read + Write' permission level is selected; and Step 3 points to a button with a '+' icon used to create the token

Copy the Token

'alphanumeric access token' outlined with arrow

6. Select the ‘Files’ Tab

Insurgency Standstorm "Files"tab outlined with arrow in Cybrancee panel.

7. Open the ‘Game.ini’ file

Navigate to:

Insurgency/Saved/Config/LinuxServer/

'Game.ini'file outlined with arrow

8. Edit the ‘Game.ini’ File

'bHasUserAcceptedTerms and AccessToken' outlined with arrow
Configuration ElementExact CodeNotes
Header Section[/Script/Modkit.ModIOClient]Ensure this is at the top of the block. Use this specific header for Mod.io authentication.
Command Line (Terms)bHasUserAcceptedTerms=TruePlace directly under the header. This confirms to the server engine that you accept Mod.io’s terms of service, allowing downloads.
Command Line (Token)AccessToken=YOUR_TOKEN_HEREPlace directly under the terms command. You must replace YOUR_TOKEN_HERE with the long alphanumeric string you copied from the Mod.io website.

9. Locate Your Mod IDs

Go back to the Insurgency: Sandstorm Mod.io page and browse for the mods you want.

Insurgency: Sandstorm Mod.io page

Obtain the Resource/Mod ID

Click on a mod to view its details.

'Resource ID' outlined with arrow

10. Open the ‘Mods.txt‘

Navigate to:

Insurgency/Saved/Config/LinuxServer

'Mods.txt' outlined with arrow

If it does not exist, click New File, name it exactly Mods.txt, and click Create.

11. Add the Mods to ‘Mods.txt‘ File

'Resource/Mod ID' outlined with arrow

Paste the Mod/Resource ID numbers you copied

12. Activate the Custom Maps

Go to your Cybrancee Startup tab

'Startup' tab outlined with arrow

Locate the Default Map and Scenario Name variable

Important:

Do not combine multiple scenarios in this box, and ensure the Default Map matches the map used in your Scenario Name, or your server will crash on startup!

Locate the Default Map variable. Enter the base name of your custom map (e.g., Sheds).

Locate the Scenario Name variable. Paste only one scenario line provided by the mod author (e.g., Scenario_Sheds_Outpost).

Arrow 1 points to the 'DEFAULT MAP' field containing the text 'Sheds', and Arrow 2 points to the 'SCENARIO NAME' field containing the text 'Scenario_Sheds_Outpost'

Add Mutators to Your Map Rotation

Navigate to:

Insurgency/Saved/Config/LinuxServer

'MapCycle.txt' outlined with arrow

Go to the Mod.io page for your downloaded map. The mod author will list the specific game mode scenarios available for their map

'Scenarios' outlined with arrow

Copy the scenarios that match your server’s intended game mode and paste them into the text editor. You must place only one scenario on each line.

13. Restart Your Server

Insurgency: Sandstorm Server Hosting

Starts at $4.99

External link icon
Was this article helpful?
Please Share Your Feedback
How Can We Improve This Article?
Table of Contents