30% OFF First Invoice

Code at Checkout: TRICKYTRIALS

How to Install Workshop Mods and Maps for an Unturned Server

Last modified on Nov 22, 2023 in unturned

mc head By Dalton Whalen


When playing vanilla Unturned, the included gameplay and maps may exhaust their usefulness. Since Unturned is not procedurally generated, the map is always the same, leaving desires to have a unique experience. Luckily, Unturned has Steam Workshop support, allowing you to use player-created maps and mods to renew your adventures. Installing these workshop maps and mods can be confusing, so we have created this Apex Hosting guide to ease you through the setup process.

Locating Workshop Content

  1. Navigate to the Unturned Workshop page.
  2. Open a mod that you plan to install.
  3. In the URL, locate the ?id= section.
    Unturned Workshop ID
  4. Make note of the numerical ID number or paste it in a notepad for later.
  5. Once you have all desired mods saved, you can continue to the next steps.


Locating the Automatic Downloader

  1. Navigate to the Apex Server panel, then stop your server.
  2. Proceed to the FTP File Access on the left-hand side, then log in.
  3. Locate and enter the Servers folder, then open the folder with a globe symbol.
    Unturned Workshop Map Name
  4. Find the WorkshopDownloadConfig.json file, then press Edit to the far-right.
    Unturned Workshop Edit


Configuring the Downloader

  1. Once the file is open, locate the File_IDs section.
    Unturned Workshop File
  2. In-between the white brackets, use Enter to put a space for each mod you add.
    Unturned Workshop File
  3. On each blank line you added, paste in each mod ID from earlier.
  4. Place a comma at the end of each ID number, except for the last one.
    Unturned Workshop File
  5. Press Save once complete, then restart the server.

The server should now begin downloading each of the server mods upon startup!

Manual Mod Installation

When using mods from the official Steam Workshop, we highly recommend using the automatic downloader. However if there are mod or map files from another source, they can be manually added as well.

  1. Proceed to the FTP File Access, then log in.
  2. Continue to the Servers folder, select your world folder, then enter the Workshop folder.
  3. Depending on your mod, either proceed to the Maps folder or Content for other mods.
    Unturned Workshop Folders
  4. Press Upload in the top-left, then drag + drop the mod file.
  5. Once complete, restart the server to load up the mods.


Loading Modded Maps

  1. Proceed to the FTP File Access, then log in.
  2. Continue to Servers > [Your World Name].
    Unturned Workshop FTP
  3. From here, navigate to Workshop > Steam > Content > 304930.
    Unturned Workshop FTP
  4. Open the folder with your map’s Steam ID.
  5. Here should be a file named map.meta and a folder. Copy the folder name.
    Unturned Workshop Mod Name
  6. Return to the main panel page, then navigate to the Config Files.
  7. Open the commands.dat file, then enter the following:
    map [MapName]

  9. Replace [MapName] with the copied folder name, then save.
    Unturned Workshop Change Map
  10. Restart the server to load up the custom map!


Common Issues

The mods aren’t installing:
If the mods are not installed, we recommend checking the console during startup for errors. Sometimes, mods will be outdated due to previous Unturned updates and cannot install. If this occurs, we recommend either trying to redownload or find an alternative until updates are available.

The custom map is not loading:
If a custom map is not showing up, we recommend checking the Commands.dat file to ensure it is formatted properly. Otherwise, access the “Customizations” tab on the panel, then try setting the map name to be blank in the dropdown. Once done, check the Commands.dat once more and restart.

The server is crashing:
If the server is crashing, it is often caused by a loaded custom map. If you are unsure, try to unload the custom map and try again. Otherwise, if you have manually installed maps or mods, try to remove those as well. Once done, try to launch the server once more.

Helpful Links

Steam Unturned Workshop

Start Your Unturned Server

Get started with your own unturned server in 5 min and start trying out these great features.