Add Steam Workshop Maps to a Project Zomboid Server

Overview

Project Zomboid has plenty of places to loot, barricade, and eventually regret entering. After enough runs through the same towns, though, a new map can make the apocalypse feel fresh again. Steam Workshop maps can add expanded areas, redesigned locations, or entirely new places to survive.

This guide explains how to subscribe to a Workshop map, find the needed files, upload them to your Project Zomboid server, and update the server configuration so the map loads correctly.

Subscribe to the Workshop Map

1. Open the Project Zomboid Workshop page in Steam.
2. Find the map you want to install.
3. Open the map page, then click the green Subscribe button.

1. Launch Project Zomboid at least once after subscribing. This allows Steam to finish downloading and installing the Workshop files locally.

Find the Map Files on Your Computer

1. In Steam, open your Project Zomboid game page.
2. Click the gear icon.

1. Select Manage, then choose Browse local files.
2. In the file path at the top of the folder window, click steamapps.
3. Go to `workshop/content/108600`.

1. Open the folder that matches the map's Workshop mod ID.
2. Continue through `mods/MapName/media`.

1. Note the folder names inside this location. These map folder names are needed when editing the server settings.

Upload the Map to the Server

1. Open your server panel.
2. Stop the Project Zomboid server before changing files.
3. Open your file manager or FTP client from your panel menu.
4. Navigate to the server's `media` folder.
5. Click Upload, then drag and drop the map folders you found earlier.

1. Wait until the upload reaches 100%, then return to the main server panel.

Update the Spawn Regions File

The files are now on the server, but Project Zomboid still needs to know where the new spawn data is located.

1. In the server panel, open Config Files.
2. Select `world_spawnregions.lua`.

1. Add a new line using this format:

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

1. Replace both instances of `MapName` with the folder name you found earlier.

1. Save the file, but do not restart the server yet.

Edit the World Configuration

1. Return to Config Files.
2. Open the World Config file.
3. Find the Mods field and enter the mod ID from the Workshop page.

1. In the Map field, add the map folder name from the local files.
2. In WorkshopItems, enter the map's numerical Workshop ID.

1. Save the configuration, then restart the server.

Join With the New Map

Launch Project Zomboid and join the server normally. For best results, connect with a new user account so the fresh spawn options can appear correctly. If everything was entered properly, the Workshop map should be available as a starting area.

Removing the Map Later

To remove the map, stop the server, delete the uploaded map folders, and remove the related entries from `world_spawnregions.lua`, Mods, Map, and WorkshopItems. Restart afterward so the server loads the cleaned configuration.

Helpful Links

• Project Zomboid Workshop page
• How to join a Project Zomboid server