Skip to content Nodecraft
Support / Unturned / Installing Steam Workshop Mods and Maps to your Unturned Server

Installing Steam Workshop Mods and Maps to your Unturned Server

Subscribe to Mods or Maps on Steam Workshop

Subscribe to the workshop content you want to use on your server from the Steam client, and let it download to your PC. We recommend you have a text document on hand open such as Notepad++, if you plan on using the automatic download method. You will use the program to help you record and transfer the Steam Workshop ID numbers for each mod you want to install to your server. Write them down as you subscribe to them in Steam. You can see their ID numbers on each workshop addons URL link.

Location of the Workshop ID number for an Unturned Map

You can also pull up a list of all the mods you've subscribed to if you enter the Steam Workshop, and click "Browse", then "Subscribed Items". This list won't show the Steam Workshop ID number however, you will need to click on each one to bring you to their pages to find their ID numbers like in the example above.

Location of the list of subscribed workshop content for Unturned on Steam

Automatic Download Method

In order to use the automatic workshop ID download method, you must navigate to the unturned folder, which is inside the server folder in the main directory of the File Manager on the left hand side of your NodePanel. If you don't see an unturned folder there, it means you have not started the server as least once yet. The game will create a series of folders and files when it starts up. Once the server has started up, stop it, and when you look in the servers folder, you should see a newly created unturned folder.

Inside the unturned folder will be a file called WorkshopDownloadConfig.json. Select the file and then click on the "Edit" button.

The WorkshopDownloadConfig.json file for an Unturned server within NodePanel

If this is the first time opening this file, you will see something like the screenshot below.

A view of the workshopdownloadconfig file for the game unturned

The line you need to edit is the first one, File_IDs. You will be placing all of the Workshop ID numbers you've recorded in your text document (Notepadd++) and entering them in between those 2 brackets.

The File_IDs setting for Unturned to download the workshop content within NodePanel

Press Enter on your keyboard a couple times to give yourself some space to add in the ID numbers like so:

A view of the config file for workshopdownloads in unturned, with space made to insert the workshop id numbers

In between the white brackets, put each ID number on it's own line. Add a comma after each ID number, except for the last ID number which needs no comma at the end. Remove any blank lines from the config file, until it looks something like the screenshot below.

A view of the workshopdownload config file with two workshop id numbers added

Do not alter any other part of the config file, the other lines in the config are required for the config file to do it's job correctly.

When you're finished making edits, click the blue "Save" button in the upper right corner. You're all set to start your server up, and it will begin the process of downloading the workshop content.

You will see in the Console section of the control panel that the Steam Workshop mods are being downloaded, and installed automatically. Using this method, the game automatically sorts the mods into the correct folders (maps into "Maps", other items into "Content" in the /server/unturned" directory).


(the red block is the server IP, which we covered up for this picture)

A Note about Workshop Downloads for Unturned

After the developer of Unturned switched the core graphics engine used by the game some time ago (Version 3.28), much of the content on the Steam Workshop became outdated and unusable in the game. The developers of the mods and maps had to update their creations to make them work with the major changes that were introduced in that version. Many mods and maps had been abandoned by their authors, and were never updated.

This became a huge issue, as people found and tried to use this outdated content on their servers, which usually resulted in the server instantly crashing.

Because of this, the developer had to add a feature to the automatic downloader that looks to see if the mod or map has been updated to run on the new Unity 2017 version of the game. If it has NOT been updated, the game will not download it. The game will skip that workshop ID and continue trying to download others on the list. If the entire list of Workshop ID numbers you have added to the file are outdated, it will skip them all. If the automatic downloader will not download it, we highly recommend that you do not try installing it manually. As mentioned above, this usually caused servers to crash instantly on startup.

Also, as part of that same doublechecking process, the game can now detect that a mod you have added to the list requires another base mod to work correctly, and it will automatically download that other mod too. Because of this feature, you may see messages in the console that it had downloaded less or more mods then you entered.

Manual Method of Installing

Given how easy the automatic method is for installing mods, we're only including this method in case you are using mods that are not carried in the Steam workshop for Unturned.

  • Navigate to the folder server/unturned/workshop on your server.

  • Inside you will see a Maps folder and a Content folder.

  • Upload mods to the appropriate folder, maps go into Maps, and items/vehicles/objects go into Content.

If the non-Steam Workshop mods will not load, contact the author of the mods for more assistance with how to properly load them.

Create a Unturned Server today!
Start Free Trial

Chat blocked!

Nodecraft is an ad-free website! Disable adblock if you have any questions.