Skip to content

Squad: Installing Mods

Learn how to install Steam Workshop mods on your Squad game server and add mod layers to the rotation → Learn more now

19 November 20263 min read3 Views0 helpful

Don't have your own server yet? Host your Squad server with ZAP-Hosting.

Introduction

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.

Find the Workshop ID

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:

Code
https://steamcommunity.com/sharedfiles/filedetails/?id=1234567890

In the panel, you can enter either just the ID or the full link.

Add mods in the Workshop tab

  1. Open the Workshop tab for your game server.
  2. 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.
  3. Click Add.
  4. 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.

Warning

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.

Add mod layers to the rotation

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, MapRotationMode determines how the rotation works. The default is LayerList_Vote, where players vote on the next layer at the end of a round. With LayerList, layers run in the order listed in LayerRotation.cfg; with LayerList_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:

cfg
// Mod layers
MeinModLayer_AAS_v1
AlBasrah_AAS_v1
Important

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.

Conclusion

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! 🙂

FAQ

Frequently asked questions

Enter the mod's Workshop ID or link in the Item IDs field in the Workshop tab, click Add, and restart your server. The server will download the mod automatically when it starts.
Restart your server. Each time it starts, it checks for updates and downloads any modified mods again.
The server only plays layers in its rotation. Add the mod's Layer ID to ServerConfig/LayerRotation.cfg or, for voting, to ServerConfig/LayerVoting.cfg, then restart your server.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 people found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.