Skip to main content
To add Steam Workshop mods to an Unturned server, open Servers/PterodactylUnturned/WorkshopDownloadConfig.json in the File Manager, put each mod’s File ID in the File_IDs list and restart. You can also add a Workshop collection’s ID: the server downloads every item in it, plus each item’s dependencies. Players download the same mods automatically when they join.

​
Before you start

  • The server needs a valid GSLT. It creates WorkshopDownloadConfig.json and downloads mods only after it has logged on to Steam (Steam servers ready!). If the file isn’t there yet, start the server once with a valid token.
  • Make a backup before adding many mods.

​
How to find a Workshop File ID

Open the mod or collection on the Unturned Steam Workshop. The File ID is the number at the end of the address:

​
How to add mods or a collection

1

Stop the server

Stop the server.
2

Open the file

In the File Manager, open Servers/PterodactylUnturned/WorkshopDownloadConfig.json.
3

Add the File IDs

Put the IDs in File_IDs, separated by commas:
4

Save and start

Save the file and start the server. The console lists each item as “queued for download”; a collection shows how many children it has.
Downloaded files go to Servers/PterodactylUnturned/Workshop/Steam. Don’t copy mods there by hand; the server manages that folder.

​
WorkshopDownloadConfig.json settings

​
How do Workshop updates work?

When a mod in use is updated, the server warns players in chat and shuts down after Shutdown_Update_Detected_Timer seconds (10 minutes by default). It does not start again on its own. Add a schedule that starts the server, or start it yourself; it downloads the update at start. This keeps the server’s version of each item the same as the players’, so they don’t get version mismatch errors when joining.

​
How to use Workshop maps

A Workshop map is added the same way. After the download, set Map on Game settings to the map’s name. See Workshop maps.

​
Frequently asked questions

​
Can I use a Workshop collection on an Unturned server?

Yes. Put the collection’s ID in File_IDs. The server downloads every item in the collection. To skip the extra items an author lists as dependencies, add that item’s ID to Ignore_Children_File_IDs.

​
Why did my mods not download?

The server needs to log on to Steam first, so check the GSLT. Also check the JSON: a missing comma makes the server reset the file to its defaults, and your list is lost.

​
Do players need to subscribe to the mods?

No. Players download the server’s Workshop items automatically when they join.

​
Are RocketMod plugins Workshop mods?

No. Plugins are .dll files in Rocket/Plugins. See plugins for Rocket and OpenMod.

Unturned server guide

Every Unturned page in one place.

Workshop maps

Download and run a Workshop map.

Curated maps list

Map File IDs.

Plugins for Rocket and OpenMod

Server plugins.

File Manager

Edit files in the panel.
Checked against the official Unturned server documentation and the game files of Unturned 3.26.3.13 on 2 November 2026; file paths checked on our Game Panel. Details may change with game updates.

​
Need Extra Help?

If you encounter any issues, our support team is ready to assist:

​
Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!
Last Updated: November 2026