How to Add Mods to Your Unturned Server

Unturned comes with its own download system for the Steam Workshop: you add the file IDs of the mods and maps you want to the file WorkshopDownloadConfig.json, and your server downloads them automatically on startup.

Find the file ID

1. Open the Steam Workshop
   Open the Steam Workshop for Unturned and look for the mod or map you want.

2. Copy the file ID
   The file ID is part of the URL of the Workshop page. Copy the number after ?id=.

Add mods to the server

1. Stop the server
   Stop your server via the dashboard.

2. Connect via SFTP
   Connect to your server via SFTP.

3. Open the configuration file
   Open the following file:

   /Servers/<ServerID>/WorkshopDownloadConfig.json
   

4. Enter the file IDs
   Add the IDs to the File_IDs section, separated by commas:

   "File_IDs":
   [
       2136497468,
       1497352180
   ],
   

5. Start the server
   Save the file and start your server. On startup all configured mods and their dependencies are downloaded and updated.

Use a Workshop map

A map from the Workshop needs two entries: the file ID so it gets downloaded, and the map name so the server actually loads it.

1. Add the file ID
   Add the file ID of the map to WorkshopDownloadConfig.json as described above.

2. Select the map
   Open the following file:

   /Servers/<ServerID>/Server/Commands.dat
   

   and enter the name of the map – one instruction per line:

   Map Elver
   

3. Start the server
   Save both files and start your server.

File IDs of popular maps

Map	File ID
Elver	2136497468
Carpat	1497352180
Hawaii	1753134636
Greece	1702240229
Arid	2683620106
Buak	3000549606
A6 Polaris	2898548949
Escalation	3251926587
France	1975500516
Ireland	1411633953
Belgium	1727125581
Kuwait	2483365750
California	1905768396
Rio de Janeiro	3416057692

Further settings in the file

Entry	Meaning
File_IDs	The list of mods and maps your server downloads
Ignore_Children_File_IDs	Dependencies that should deliberately not be downloaded
Use_Cached_Downloads	Reuse files that have already been downloaded
Should_Monitor_Updates	The server watches whether an update is available for a mod
Shutdown_Update_Detected_Timer	Waiting time in seconds before shutting down after a detected update (default 600)
Shutdown_Update_Detected_Message	Message players see when an update is detected
Shutdown_Kick_Message	Message shown when players are disconnected

Remove mods

1. Stop the server
   Stop your server via the dashboard.

2. Delete the entry
   Remove the file ID from the File_IDs section and make sure there is no comma after the last remaining ID.

3. Start the server
   Save the file and start your server.

Common problems