Add Custom Maps

Install community-made map mods on your Project Zomboid server, including popular maps like Raven Creek and Bedford Falls.

Project Zomboid supports custom map mods from the Steam Workshop, adding new towns, cities, and locations to explore. This guide shows how to install and configure them.

MapWorkshop IDDescription
Raven Creek2196102849Dense urban city with high-rise buildings
Bedford Falls522891356Rural town with farms and suburbs
Grapeseed2464631999Small mountain town
Cherbourg2713644189French-inspired coastal city
Eerie Country2092383287Expanded rural areas
Fort Redstone2421762049Military base location

📝 Note: Always check Workshop mod pages for compatibility with your server's game version.

Install a Map Mod

Find the Workshop ID

On the Steam Workshop page, find the Workshop ID from the URL. For example, Raven Creek's URL contains 2196102849.

Add the mod to your server config

On XGamingServer, go to Files and open Zomboid/Server/[servername].ini.

Find the WorkshopItems= line and add the Workshop ID:

[servername].ini
WorkshopItems=2196102849;522891356

Multiple IDs are separated by semicolons.

Add the mod name

Find the Mods= line and add the mod's internal name:

[servername].ini
Mods=RavenCreek;Bedford Falls

💡 Tip: The mod's internal name is usually listed on its Workshop page. It may differ from the display name.

Add the map to the map list

Find the Map= line and add the map name:

[servername].ini
Map=Muldraugh, KY;Riverside, KY;Rosewood, KY;West Point, KY;RavenCreek

⚠️ Warning: Always keep the default maps (especially Muldraugh, KY) in the Map line. Removing them can cause issues.

Restart your server

Restart from the Dashboard. The server will download the map mod from the Workshop.

Add Spawn Points for Custom Maps

By default, players can only spawn in vanilla locations. To add spawns for custom maps, you may need to edit spawn configuration files or use a mod that adds spawn points for your map.

Some map mods include spawn points automatically. Check the mod's description.

Troubleshooting

Map not loading:

  • Verify the Workshop ID is correct
  • Check that the mod's internal name matches exactly in the Mods= line
  • Ensure the map name is correctly added to the Map= line

Players can't see the map:

  • Clients need to download the mod too — this happens automatically when they join
  • Large map mods may take several minutes to download

Server crashes on start:

  • The map may be incompatible with your game version
  • Try removing the map and starting the server to confirm it's the cause
  • Check the Console for error messages

See also: Install Mods | Configure Your Server | Reset World

If you need help, join our Discord.

How is this guide?

40% Off — Limited TimeGet your Project Zomboid server todayInstant setup, DDoS protection, and 24/7 support included.
Get a Server

On this page