How to add a Custom Map to your Project Zomboid server

Adding a custom map to your Project Zomboid server can enhance your gaming experience significantly. This guide will walk you through the necessary steps to successfully add a custom map to your server. Before starting, it is crucial to shut down your server to prevent data corruption. This will ensure that your modifications go smoothly without any risks of breaking your server data.

Common Sites for Custom Map Files

• Steam Workshop – The most popular site for Project Zomboid mods and the one recommended, given its internal functionality woven into the game and server, including custom maps.
• Nexus Mods – Another excellent source for various mods and custom maps.

• Project Zomboid Community – A hub for players to share their creations and mods.

   

Step-by-Step Guide to Add a Custom Map

1. Subscribe to the map mod and any dependencies stated by the modded map. Make sure to check the mod description for any necessary items.

1. Connect to your FTP as detailed in our FTP guide. This will be your first experience using FTP, and it will help you transfer files safely to your server.
2. Transfer the map file found usually in <strong>C:\Program Files (x86)\Steam\steamapps\workshop\content\108600\MODID#\mods</strong> (For example, for the Cherbourg map, this would be <strong>C:\Program Files (x86)\Steam\steamapps\workshop\content\108600\1827428289\mods\cherbourg</strong>) to the <strong>media/maps</strong> folder inside your server.

1. Go to Basic Settings (or in the config template for <strong>servertest.ini</strong> under the <strong>Mods</strong> line if you have one active) and change the map to the name indicated in the workshop mod. In our example, it would be <strong>cherbourg_map;cherbourg</strong>.

1. In Basic Settings (or in the <strong>Map</strong> line in the config template for <strong>servertest.ini</strong> if you have one active), add the Map variable with <strong>InGameMaps_cherbourg_SP;cherbourg</strong>.

1. In the Basic Settings (or the <strong>WorkshopItems</strong> line if you have one active in the config template for <strong>servertest.ini</strong>), add the Workshop Items variable with <strong>2763515304;1827428289</strong>.

1. This step is optional, but very recommended. If there is no <strong>servertest.ini</strong> config template made, create one and change <strong>Anti Cheat Protection Type 12</strong> to FALSE. The line should read: <strong>AntiCheatProtectionType12=false</strong>. 

1. Go to the Config Manager and create a config file for <strong>servertest_spawnregions.lua</strong>. This is essential to avoid errors related to spawning on the vanilla map. Each map may have different regions created. 

    

If there's no folder for a specific region, insert <strong>Random</strong> in the region name, followed by the path. 

Since you have added the map files in the map folder of the server via FTP. Update the servertest_spawnregions.lua via Config Manager. You can follow this screenshot for the best description:

function SpawnRegions()
    return {
        { name = "Random", file = "media/maps/cherbourg/spawnpoints.lua" },
        -- Uncomment the line below to add a custom spawnpoint for this server.
--      { name = "Twiggy's Bar", serverfile = "servertest_spawnpoints.lua" },
    }
end

1. Click Override Boot Config - Use as default, save the config template, and restart your server.

Troubleshooting Common Issues

• Map not loading: Ensure you set the designed path correctly and that your server is updated.
• Server isn't working: Double-check the servertest_spawnregions.lua file for accuracy in the spawn region entries. The game tends to fail or use the vanilla map.
• Error messages: Review the server logs for any specific issues, they can guide you on what's wrong.

By following these steps, you should be able to add and enjoy your new custom map on your Project Zomboid server. 

Happy gaming!