How to Add Workshop Maps to Your Project Zomboid Server

Custom workshop maps expand your Project Zomboid world beyond the default locations. With the Steam Workshop page in your game panel, you add a map the same way as any other mod: no FTP and no copying files. The map's name is added to your server's map list for you.

Before you start: Stop your server before changing mods or maps, and create a backup with Create Backup in the game panel.

Add the map

1. Stop your server from the game panel.
2. On your server's page, click Steam Workshop.
3. Open the Browse Workshop tab, search for the map and click Pick. You can also paste the map's Workshop link on the Add mods tab instead.
4. Click Review and add, then Add selected. The map downloads to your server and is ticked on the Mods tab automatically.
5. Check the map shows a map: tag on the Mods tab. That's the map name that has been added to the Map= setting for you, before Muldraugh, KY.
   If the map shows No Build 42 version (or No Build 41 version), it isn't made for the build your server runs and won't load. Choose a version of the map made for your build.

Check the map order

6. Open the Load order tab. The Map= list shows the maps your server loads, in order. Maps higher in the list take priority where two maps overlap.
   Keep Muldraugh, KY as the last entry. Where a map listed after it overlaps the base map, the base map wins, so changes inside Knox County (such as extra spawns or edited buildings) won't show. New maps are added before it for you, and if it isn't last, click Move to the end next to it.
7. If the map's Workshop page gives a Map ID that isn't in the list, type it into the Add map box under the list exactly as written, and click Add map.
8. Click Save changes if you changed anything on this tab.

Configure spawn regions (optional)

Your map loads without this step. Add a spawn region only if you want players to be able to spawn in the new map.

9. In your game panel, go to Configuration Files and open servertest_spawnregions.lua with Text Editor.
10. The file lists spawn regions and links them to map paths. By default it includes the four base maps. Add your custom map by inserting a new line pointing to its spawn file. For example, to add BedfordFalls:

    function SpawnRegions()
          return {
                { name = "Muldraugh, KY", file = "media/maps/Muldraugh, KY/spawnpoints.lua" },
                { name = "West Point, KY", file = "media/maps/West Point, KY/spawnpoints.lua" },
                { name = "Rosewood, KY", file = "media/maps/Rosewood, KY/spawnpoints.lua" },
                { name = "Riverside, KY", file = "media/maps/Riverside, KY/spawnpoints.lua" },
                { name = "BedfordFalls", file = "media/maps/BedfordFalls/spawnpoints.lua" },
          }
     end
    

    
    Use the map name shown in the map: tag on the Mods tab in the path. Repeat for each additional map.
11. Save the file.

Start your server

12. Start your server. It loads the new map on startup.

Mods and maps you add on the Steam Workshop page stay up to date on their own: your server checks for Workshop updates every time it starts. If a map is updated on Steam while your server is running, a number appears on the Steam Workshop icon and the Mods tab shows Restart needed. Restart your server to load the update, or create a scheduled task with Scheduled Tasks > Update Workshop files to restart it for you. See add mods for more.