Menu
  Log out
 

Workshop Install Folder Error - Unturned Wiki

Unturned Guide • Updated Mar 29, 2026

Fix Unturned Dedicated Server Workshop Install Folder Errors

If your dedicated server suddenly stops loading Workshop mods and complains that it cannot find the install folder, the usual cause is a broken U3DS install path, stale Workshop cache, or a bad WorkshopDownloadConfig.json entry.

Quick Answer

First validate the Unturned Dedicated Server app itself, then rebuild the server-side Workshop folder, and finally verify that every Workshop file ID is valid and public. If you are using private Workshop content, the dedicated server cannot download it anonymously.

What to Check First

Check Healthy State If Broken
U3DS install path Server files live under the normal steamapps/common/U3DS/ tree Reinstall or repair the dedicated server tool
Workshop config File_IDs contains only valid numeric IDs Remove bad IDs and regenerate the folder
Workshop cache Freshly downloaded content matches active mods Delete stale Workshop folders and restart
Private items Handled manually with SteamCMD and symlinks if needed Do not expect anonymous U3DS download to work

Repair Sequence

  1. Stop the server completely.
  2. Validate or reinstall the Unturned Dedicated Server app so the base U3DS folder is restored correctly.
  3. Open Servers/YourServerName/WorkshopDownloadConfig.json and confirm the JSON is valid.
  4. Remove the server's local Workshop directory inside that server instance.
  5. Restart the server so it rebuilds the folder from the current mod list.
  6. If the error started right after adding a new mod, remove that mod ID first and test with the previous known-good set.

Minimal Valid Workshop Config

{
  "File_IDs": [
    1234567890,
    9876543210
  ]
}

Private Workshop Files

Official Unturned documentation notes that the dedicated server cannot sign into a Steam account to download private Workshop files. Those need to be downloaded through SteamCMD with an authenticated account and then linked into the server manually. If a mod recently changed from public to private, that alone can explain a sudden install-folder failure.

Linux note: If the folder structure is correct but downloads still fail, verify the server process owns the Workshop directories and can create subfolders under the active server instance.

When a Full Reinstall Is Faster

  • The server used to work and now even vanilla maps fail after multiple mod edits.
  • You moved the U3DS folder manually and relative Workshop paths are now wrong.
  • The install mixes files from Steam Library and SteamCMD deployments.
  • The same config works on another machine but not on this one.

Running a heavily modded server? Host your Unturned server on a setup where Workshop paths, restarts, and backups are easier to manage than on a hand-maintained local install.

← Back to Unturned Guides
Top