How To Install Mods On Your Project Zomboid Server
Learn how to install mods on your Project Zomboid dedicated server.
Mods are a great way to customize your Project Zomboid server beyond the default gameplay settings. You can add new items, change zombie behavior, tweak mechanics, and much more using Steam Workshop mods. This guide walks you through the full installation process.
Getting Mod and Workshop IDs
Every mod you install requires two pieces of information: the Workshop ID and the Mod ID. You can browse all available mods on the Project Zomboid Steam Workshop.
When you find a mod you want to install, look for these details:
- Workshop ID — The number in the mod's URL. For example, in
https://steamcommunity.com/sharedfiles/filedetails/?id=3378304610, the Workshop ID is3378304610. - Mod ID — Listed on the mod's Workshop page under the details section. For the example above, the Mod ID is
RepairableWindows.
💡 Tip: Always check a mod's Workshop page for any required dependencies. Missing dependencies will cause the mod to fail silently or crash your server.
Installing Mods
Stop Your Server
Log in to the XGamingServer Panel and stop your server.
Open the Server Config
In the sidebar, go to Files and navigate to .cache/Server/pzserver.ini.
Add the Workshop IDs
Find the WorkshopItems line and add your Workshop IDs, separated by semicolons:
WorkshopItems=3378304610;2849467715Add the Mod IDs
Find the Mods line and add your Mod IDs, also separated by semicolons:
Mods=RepairableWindows;WaterGoesBadSave and Start
Save the file and start your server. The mods will be downloaded automatically on startup.
📝 Note: To install multiple mods, separate each entry with a semicolon (
;) — no spaces. For example:RepairableWindows;WaterGoesBad;AnotherMod.
B42 Multiplayer Modding
⚠️ Warning: B42 modding is unstable and requires a different installation process. Many mods are not compatible with B42, and you will likely encounter bugs and broken interactions. Proceed with caution.
The B42 branch uses a slightly different mod format. If this process changes in the future, this guide will be updated.
Stop Your Server
Log in to the XGamingServer Panel and stop your server.
Open the Server Config
In the sidebar, go to Files and navigate to .cache/Server/pzserver.ini.
Add Workshop IDs
Add your Workshop IDs to the WorkshopItems line, separated by semicolons:
WorkshopItems=3378304610;2849467715Add Mod IDs with Backslash Prefix
On B42, each Mod ID must be prefixed with a backslash (\) and separated by semicolons:
Mods=\RepairableWindows;\WaterGoesBad;\LastModSave and Start
Save the file and start your server.
💡 Tip: If your server crashes after adding B42 mods, try removing them one at a time to identify the incompatible mod. You can also check the server console for error messages.
How is this guide?
Configure Infection and Mortality Settings
Customize zombie virus transmission, mortality timelines, and reanimation on your Project Zomboid server. Includes the difference between Knox Infection and wound infection.
Configure Loot Respawn
Set up loot respawn timing, abundance, and behavior on your Project Zomboid server.