How to Add Workshop Maps to Your Project Zomboid Server

Custom workshop maps expand your Project Zomboid world beyond the default locations. This process requires FTP access to transfer the downloaded map files to your server. Before following these steps, complete add mods first to install the map as a mod.

Before you start: You must add the map as a mod before following this guide. Stop your server before making file changes.

Install the map mod

1. Stop your server from the game panel.
2. Follow the add mods guide to install the desired workshop map as a mod on your server.

Upload map files via FTP

3. Connect to your server using an FTP client such as FileZilla.
4. Create a mods folder in your server's root directory if it does not already exist.
5. On your local PC, download the desired maps through Steam Workshop.
6. Locate the downloaded files. The default path is:

   C:\Program Files (x86)\Steam\steamapps\workshop\content\108600
   

   
   Folder names in this directory correspond to the Workshop IDs of the maps.
7. Copy the desired map folders from your PC and upload them into the mods folder on your server via FTP.
8. Copy all contents of the media folder found in each uploaded map and place them into /media/maps on your server. If prompted to overwrite files, confirm the overwrite.

Configure spawn regions

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:

    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" },
          }
     end
    

11. Add your custom map by inserting a new line pointing to its spawn file. For example, to add BedfordFalls:

{ name = "BedfordFalls", file = "media/maps/BedfordFalls/spawnpoints.lua" },

Repeat for each additional map, making sure each path matches the folder you uploaded.

Update the map list

12. Still in Configuration Files, open servertest.ini with Text Editor.
13. Find the line that reads Map=Muldraugh, KY.
14. Add your custom maps before Muldraugh, KY, separating each with a semicolon (;). For example:

    Map=BedfordFalls;Muldraugh, KY
    

    
    Muldraugh, KY must remain the last entry or other maps will not load.
15. Save the file and start your server.