# How to Add Custom Maps to Your Project Zomboid Server (/docs/project-zomboid/custom-maps)



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.

Popular Map Mods [#popular-map-mods]

| Map           | Workshop ID | Description                               |
| ------------- | ----------- | ----------------------------------------- |
| Raven Creek   | 2196102849  | Dense urban city with high-rise buildings |
| Bedford Falls | 522891356   | Rural town with farms and suburbs         |
| Grapeseed     | 2464631999  | Small mountain town                       |
| Cherbourg     | 2713644189  | French-inspired coastal city              |
| Eerie Country | 2092383287  | Expanded rural areas                      |
| Fort Redstone | 2421762049  | Military base location                    |

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

Install a Map Mod [#install-a-map-mod]

<div className="fd-steps">
  <div className="fd-step">
    Find the Workshop ID [#1-find-the-workshop-id]

    On the Steam Workshop page, find the Workshop ID from the URL. For example, Raven Creek's URL contains `2196102849`.
  </div>

  <div className="fd-step">
    Add the mod to your server config [#2-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:

    ```ini title="[servername].ini"
    WorkshopItems=2196102849;522891356
    ```

    Multiple IDs are separated by semicolons.
  </div>

  <div className="fd-step">
    Add the mod name [#3-add-the-mod-name]

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

    ```ini title="[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.
  </div>

  <div className="fd-step">
    Add the map to the map list [#4-add-the-map-to-the-map-list]

    Find the `Map=` line and add the map name:

    ```ini title="[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.
  </div>

  <div className="fd-step">
    Restart your server [#5-restart-your-server]

    Restart from the **Dashboard**. The server will download the map mod from the Workshop.
  </div>
</div>

Add Spawn Points for Custom Maps [#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 [#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

Related Guides [#related-guides]

See also: [Install Mods](/docs/project-zomboid/mod-setup) | [Configure Your Server](/docs/project-zomboid/server-config) | [Reset World](/docs/project-zomboid/world-reset)

If you need help, join our [Discord](https://discord.xgamingserver.com/).