Insurgency

Insurgency

48 ratings
Server Side Workshop (updated 4.1.2020)
By Arc and 2 collaborators
This guide is needed for those who want to enable Steam Workshop support on their servers.
   
Award
Favorite
Favorited
Unfavorite
Intro
For the new update, we’ve made some changes to the Steam Workshop system. There are currently 2 types of Workshop, for simplification i'll call them Current and Legacy.

Current system should work with no problem both on Windows and Linux server as well.
Legacy system may work on Windows server but it is not recommended to use and may cause some server deadlocking.
1.) Setting up the Workshop support
First add this parameter to the startup file (command line)
-workshop


This will enable workshop support for server.

Now tell the server which files should be downloaded.
Navigate to:
..\YourServerName\insurgency

create a TXT file and rename it to:
subscribed_file_ids
(click to enlarge)



In case you want to use your own custom modification or map, you need to upload it on Steam Workshop through the game client first.

Then navigate through the Steam Workshop:
http://steamcommunity.com/workshop/browse?appid=222880

and find a mod that you want to have on your server. Locate its ID number. The mod’s ID number can be found here, as highlighted in this picture (click to enlarge):




Copy that ID number to the "subscribed_file_ids.txt" file you have just created. Multiple ID’s can be placed, just be sure it is one ID per line.




Start the server and it will attempt to download all the Workshop mods.
2.) Current Workshop system
Any mod updated/uploaded after July 26, 2015 game patch sits on current workshop system and may be used server-side. Additionally, maps in current workshop will have separate BSP, NAV and TXT files.

Attention !
It is necessary to add mod ID number to "subscribed_file_ids.txt" file, otherwise clients won’t recognize the mod and will be disconnected.

Server-side folder structure:
...\YourServerName\steamapps\workshop\content\222880\



Client-side folder structure:
..\SteamLibrary\steamapps\workshop\content\222880\

This directory contains both VPK mods and custom maps. Each folder under this directory correlates with the Workshop ID.

Mapcycle file structure for New maps is same as for the official ones:
mapname modename



Yes, it works on Linux server !

If you have VPK mod containing Theater script or Playlist, you will use normal methods for getting them to work: "mp_theater_override" and "sv_playlist" respectively.
3.) Legacy Workshop items
Legacy workshop mods will not work on Linux server. They may work on Windows server, but it'll probably bring more problems than it is worth. I highly recommend to avoid those as they are probably outdated anyway.

Folder structure for maps:
..\YourServerName\insurgency\maps\workshop\ID_number

for other modifications in VPK format:
..\YourServerName\insurgency\custom\workshop

Mapcycle file structure:
workshop/id#/mapname modename

4.) Collections
Since May 26h, 2016 server now support Workshop Collections. It works a bit differently than in other Source engine games. You can mix workshop IDs with file IDs if you want.

Be sure that your server have Workshop enabled (see Step 1) then copy "Collection ID"


put it in "subscribed_file_ids.txt"



restart the server and it will download all content from the collection.

Only current Workshop mods and maps are supported, legacy will deadlock the server !!

5.) Subscribing to mod which have "item requirement"
As you may or may not know, Server Side Workshop does support modifications that requires other mods to work properly. These are linked via “required item” function in Steam Workshop page of such mod.

Only main mod ID is needed to subscribe server side, any required item will be then downloaded/mounted automatically and will be correctly pushed for clients.



I will use my server mod as an example:
http://steamcommunity.com/sharedfiles/filedetails/?id=490323818

As you can see, my mod’s ID is “490323818” and have one additional mod set as “required item”:


This "required mod" is Tigg’s “Insurgency: Arsenal” and can be found here:

http://steamcommunity.com/sharedfiles/filedetails/?id=626093257


Only my mod’s ID “490323818” is listed in “subscribed_file_ids.txt”. Upon server restart, both main mod and required mod are installed and mounted on the server:


146 Comments
SANGY 24 Sep, 2023 @ 1:01pm 
Also note: once you have entered a server that is using mods, these mods will be considered as SUBSCRIBED even if you did not subscribed them in workshop, and you can NOT unsubscribed them by deleting the mod file and appworkshop_222880.acf file(because steam will re-download them in a few minutes), the way I found to unsubscribed is to uninstall the whole game.
SANGY 24 Sep, 2023 @ 12:51pm 
for anyone who is encounter "Missing Map xxx.bsp“ problem when connecting as client, verify integrity of game files can solve this problem.
BesS 8 Sep, 2023 @ 10:31am 
Thanks for the help.
Arc  [author] 8 Sep, 2023 @ 10:29am 
Feel free to read my other guides so you can understand what i'm saying a bit better.

Remove "sv_playlist" variable from your config files or launch script, wherever it is in your specific case.
You can use search function when editing your own config files and find the exact string, and either comment it with double shash or remove it from the config file.
BesS 8 Sep, 2023 @ 10:08am 
How can I delete sv_playlist. I don't know much about this
Arc  [author] 8 Sep, 2023 @ 9:32am 
Remove your sv_playlist preset because that's enforcing specific map cycle and overrides your own and reloads a map to one allowed by the palylist.

In case this is your own custom playlist, either remove the map pool from it or add every map into it depending on what you want the palylist to do.
BesS 8 Sep, 2023 @ 9:29am 
Hello. I have such a problem. I did everything like a guide. The server is launched on the map from the workshop, but when the change is set, another one is placed, and the map disappears from the voting.
Favkis Nexerade 4 Jan, 2021 @ 2:11am 
insserver contains insurgency steamcmd.sh idk I just followed tutorial and it wanted to create insurgency folder in root folder and I wanted to be it somewhere else, so I guess that's where confusion is, yes

as for custom servers, I have an idea, it's probably that you dont need to make mp_theater_override and custom theater, just edit existing one and server would be shown in vanilla category
Arc  [author] 4 Jan, 2021 @ 1:54am 
HAHA seems like i got ninja'd (i had the tab opened for a while before writing the msg):3
Not really sure why would you have "insserver" dir and then "insurgency" unless you have multiple of them it makes no sense, and explains why I didn't think of it in my reply.

Though I can see how my guide would be confusing in such case, so I'll modify file-paths in the guide to be less ambiguous, thanks !

As for custom servers in NWI MM:
That's a hack/exploit iirc, and as Matchmaking is not be-all & end-all (and completely useless for Coop server I'm hosting), I didn't really investigate into it nor do I care personally speaking.

So can't help you with that :-/
Favkis Nexerade 4 Jan, 2021 @ 12:39am 
No it's all good, previous message describes what problem was.

Another question, why my server is in CUSTOM SERVERS tab, while there are modded theater servers in SUSTAINED combat or TACTICAL operations? How do I get in there too? No one joins CUSTOM servers tab.