Install Workshop mods on your Project Zomboid server
Use PZ Mods to install Workshop items and sync them to your server profile. You can also edit the profile manually if that panel section is unavailable.
- Check mod versions and dependencies
- Select the server profile
- Install and sync Workshop items
- Restart and test a join
Prepare mods in PZ Mods
Section titled “Prepare mods in PZ Mods”-
Check the active profile
Section titled “Check the active profile”Start the server once to let it generate a profile. Open Files → .cache → Server to find your profile, such as
OXYGames.ini, and its matching sandbox files. Open PZ Mods and check the profile shown there. Older servers may use a different name, includingPterodactyl. -
Search the Workshop
Section titled “Search the Workshop”Choose Add mods and search for the Workshop item. Read its game version, dependencies and author instructions before adding it to your draft.

-
Review the draft
Section titled “Review the draft”Open My mods and inspect the details. A selected item can show Added · not saved and Not scanned yet. The screenshot shows only an unsaved concept, not an installed mod.

-
Review before saving
Section titled “Review before saving”Choose the Build 41 or Build 42 Mod ID format used by your server, then use Review and save only after checking the profile and mod IDs. Ask support if the profile or result differs before changing a live mod list.
Edit the profile manually
Section titled “Edit the profile manually”-
Collect item and mod IDs
Section titled “Collect item and mod IDs”A Workshop ID is the numeric item ID from its Workshop URL. A Mod ID identifies a mod inside that item; use the author’s instructions and the downloaded
mod.info. One item can contain several mods. Include the required Workshop items and the Mod IDs you actually want enabled. -
Stop and open the active profile
Section titled “Stop and open the active profile”Stop the server. Use the file manager to open the active
.iniin.cache/Server/orZomboid/Server/. Keep a copy before editing; SFTP is another way to download it. If several profiles exist, confirm which one the server starts before editing. -
Set the two lists
Section titled “Set the two lists”WorkshopItems=selects downloads;Mods=selects enabled mods. Separate entries with semicolons. They are not positional pairs: do not add duplicate Workshop IDs just to make the lists the same length. Follow each author’s dependency and load-order instructions for enabled mods.A Build 42.13-era report shows a leading backslash in saved mod entries, as in the example below. The same report includes unresolved join errors. If you edit manually, compare the saved format with a profile generated by your server version.
The author of Common Sense Community Compatibility Fix lists the following IDs and dedicated-server support for 42.20.2. This is a concrete configuration example for that version, not a compatibility promise for every Build 42 patch. The author says not to enable it together with the original Common Sense.
.cache/Server/<profile>.ini Mods=\BB_CommonSenseFixWorkshopItems=3717968421Merge selected entries into your existing lists; do not replace a live mod list with this example. Click Save.
-
Start and check
Section titled “Start and check”Start the server, wait for Workshop downloads and startup to finish, then join and check the mod features. If it fails, keep the first relevant console error and both lists for support. Do not delete the world or Workshop caches as a first step.
Extra tips
Section titled “Extra tips”- Mods still not working: Follow the mod troubleshooting guide to find the first error and test a fix safely.
- Map mods: check the author’s map-folder and order instructions; check the downloaded metadata before saving.
- Existing worlds: check the mod author’s save restrictions before adding or removing a mod.
- Non-Steam/GOG: ask support which connection mode and mod installation route your server supports before using Workshop instructions.