How do I add mods to my Unturned server?

Unturned has Steam Workshop integration, allowing any workshop mods to be added to your server. You will find various kinds of mods, from adding new items, fixing quality-of-life issues, or even adding new parts to the map. Adding the workshop mods to your server can be confusing, so we created this AleForge guide to walk you through the process.

Find the Mods to Install

1. Open the Unturned Workshop
2. Search through the mods to find the mod(s) you want to add to your server. Making a list on a notepad may help.
3. When you have selected a mod, right-click on the mod page and click "Copy Page URL". Paste the URL into a notepad.
4. Make a list of the string of numbers following id=  at the end of the link. We will need them later. e.g. the 2981122063  in https://steamcommunity.com/sharedfiles/filedetails/?id=2981122063

Once you have gathered all the Mod IDs for each mod you want to install, you can start the next section to install the mods on your server.

Installing the Mods

1. Navigate to your server within the AleForge Panel.
2. Open the console for your Unturned server and ensure it is stopped. If it is not, please shut down the server.
3. Open the File Manager
4. Navigate to the WorkshopDownloadConfig.json file. It will be located at /Servers/AleForge_Hosting

5. Open WorkshopDownloadConfig.json and add your workshop IDs under File IDs . Be sure to separate each ID by a comma.

   

6. Once done, click Save Content
7. Open the Console Page and Start your server

Common Problems

My mods are not loading on the server:

• Make sure all the ID numbers have been entered correctly
• Make sure the commas are set correctly in the config file
• Make sure you are subscribed to the mods on your own computer

One mod isn't loading:

• Double-check check the ID numbers are correct and, if necessary, are in the correct order.
• Make sure the mod isn't broken or outdated for the current version of Unturned