Skip to main content
To add a Workshop map to your FREAKHOSTING Unturned server, put the map’s File ID in File_IDs in Servers/PterodactylUnturned/WorkshopDownloadConfig.json and restart so the server downloads it. Then open Game settings, type the map’s exact name in Map, save and restart again. Hawaii, for example, has File ID 1753134636. Players download the map automatically when they join.

​
Before you start

  • The server needs a valid GSLT; it only downloads Workshop items after it logs on to Steam.
  • Make a backup. Each map has its own world, so your current map’s save stays where it is.

​
How to add a Workshop map

1

Find the File ID

Open the map on the Unturned Steam Workshop. The File ID is the number after ?id= in the address. Curated maps are listed in curated maps.
2

Add it to WorkshopDownloadConfig.json

Stop the server. In the File Manager, open Servers/PterodactylUnturned/WorkshopDownloadConfig.json and add the ID to File_IDs:
3

Start the server to download it

Start the server and watch the console. The map is “queued for download”, then the server loads its maps. Note the map’s name as the console lists it.
4

Set the map

Open Game settings. Under Server, type the map’s name in Map exactly as the console shows it (names are case-sensitive). Click Review and save and Save changes.
5

Restart

Restart the server. The server now runs the new map.
Map is marked CAREFUL on Game settings: a map that is not installed stops the server from starting. Always download the map first, then change Map.

​
Which maps don’t need the Workshop?

These maps are installed on every FREAKHOSTING Unturned server: PEI, Washington, Russia, Germany, Yukon, Alpha Valley, Monolith, Destruction, Tutorial and Paintball_Arena_0. Set them in Map straight away. Some maps need extra items, such as Hawaii Assets (1753131903) for Hawaii. The server downloads the dependencies an author lists on the Workshop page automatically. If a map still complains about missing assets, add the assets item’s File ID too.

​
Frequently asked questions

​
Why won’t my server start after I changed the map?

The map isn’t downloaded yet or the name is misspelt. Set Map back to PEI, start the server, check the download in the console and try again with the exact name. See stuck on starting.

​
Do players need to subscribe to the map?

No. They download it automatically when they join.

​
What happens when the map is updated on the Workshop?

The server notices the update, warns players in chat and shuts down after 10 minutes by default. Start it again to download the new version. See Workshop collections.

​
Does changing the map delete my world?

No. Each map keeps its own save. Switching back to the old map brings its world back.

Unturned server guide

Every Unturned page in one place.

Curated maps list

Map names and File IDs.

Workshop mods and collections

WorkshopDownloadConfig.json explained.

Game settings explained

Map, mode and more.

Stuck on starting

Fix a server that won’t start.
Tested by the FREAKHOSTING team on our Game Panel on 2 November 2026 (Unturned 3.26.3.13). Workshop steps checked against the official Unturned server documentation. Steps may differ slightly if the game changes.

​
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