Unturned guide

How to Install Workshop Mods on an Unturned Server

Add Workshop maps and mods safely with WorkshopDownloadConfig.json.

Updated August 2026Vendor-neutralOfficial-documentation checked
Back up the instance and stop the server before changing configuration or plugins.

Copy the Workshop file ID

Open the item on Steam Workshop and copy the numeric ID from its URL. Confirm it is intended for Unturned and read its dependency list.

Edit WorkshopDownloadConfig.json

Stop the server and add IDs to File_IDs. Keep valid JSON syntax and do not add a trailing comma after the last value.

Configuration example

{
  "File_IDs": [
    1234567890,
    2345678901
  ],
  "Ignore_Children_File_IDs": []
}

Restart and verify

Start the server and let Steam finish each download. Read the console rather than assuming the mod loaded. Players joining the server should be prompted to download configured Workshop content automatically.

Common failures

Private items cannot normally be downloaded anonymously by the dedicated server. Also check deleted items, missing dependencies, incorrect IDs, disk space and file permissions.

Official references

Smartly Dressed Games: Setting up a Server · Server Configuration

Plan calculator · Migration wizard · Free trial

Prefer a managed control panel?

Deploy Unturned with stated resource limits, Workshop tools and scheduled backups.

View Unturned plans
Already used Monolith?

Share an honest review to help other server owners.

Review us on Trustpilot