Bring new maps, game modes, factions, or gameplay changes to your Squad game server with mods from the Steam Workshop. Add mods easily by ID in the Workshop tab, and your server will automatically download them the next time it starts. To play new maps included with a mod, add their layers to the rotation afterward.
Open the page for the mod you want to install in the Squad Steam Workshop. The Workshop ID is the number at the end of the address after ?id=, for example:
https://steamcommunity.com/sharedfiles/filedetails/?id=1234567890
In the panel, you can enter either just the ID or the full link.
- Open the Workshop tab for your game server.
- In the Add Workshop Items section, enter the mod's ID or link in the Item IDs field. Separate multiple mods with a comma, for example
9876543210, 1234567890. - Click Add.
- Restart your server. Workshop changes are always applied the next time it starts.
When your server starts, it downloads all listed mods from the Steam Workshop and places each mod in its own Workshop/<ID> folder, which you can also see in the Files tab. Squad automatically loads the mods from there. On each subsequent start, your server checks for updates and downloads any modified mods again. So, to update a mod, simply restart your server.
Each mod appears as a separate card in the Workshop tab, along with its status, such as Restart required or Active. You can also disable or remove a mod from its card. Mods that are no longer on the list are deleted from the Workshop folder the next time your server starts. You can add up to 30 mods.
Your server can only download public mods. If a mod is private or has been deleted, remove it from the list. Squad identifies mods by their .uplugin file; if it is missing, Squad may not load the mod. Your server also runs on Linux, so make sure the mod works on Linux servers.
Many mods include their own layers, which are combinations of a map and game mode. Your server only plays layers that are included in its rotation. Configure the rotation in the ServerConfig folder in the Files tab:
- In
Server.cfg,MapRotationModedetermines how the rotation works. The default isLayerList_Vote, where players vote on the next layer at the end of a round. WithLayerList, layers run in the order listed inLayerRotation.cfg; withLayerList_Randomized, they run in a random order. - In
LayerRotation.cfg, add the layers, using one Layer ID per line. - For voting, your server uses the layers in
LayerVoting.cfg, also with one Layer ID per line.
Here's an example of LayerRotation.cfg:
// Mod layers
MeinModLayer_AAS_v1
AlBasrah_AAS_v1
Always enter the Layer ID, not the display name shown in the game. Belaya_AAS_v1 is correct; Belaya AAS v1 is not. The mod creator provides the Layer IDs included with a mod. Comments must be on their own line; comments after an entry won't work in these files.
Save the files and restart your server.
Congratulations, you've installed Workshop mods on your Squad server and added their layers to the rotation. If your server won't start after you add a mod, remove the most recently added mod and check whether it works with the current game version. If you have any other questions, our support team is available every day! 🙂