Skip to content
Game panel

Install Workshop mods on your Project Zomboid server

Project ZomboidIntermediateBuild 42

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.

What you'll do
  1. Check mod versions and dependencies
  2. Select the server profile
  3. Install and sync Workshop items
  4. Restart and test a join
  1. 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, including Pterodactyl.

  2. Choose Add mods and search for the Workshop item. Read its game version, dependencies and author instructions before adding it to your draft.

    Workshop search results in PZ Mods

  3. 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.

    Unsaved mod concept and details in PZ Mods

  4. 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.

  1. 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.

  2. Stop the server. Use the file manager to open the active .ini in .cache/Server/ or Zomboid/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.

  3. 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_CommonSenseFix
    WorkshopItems=3717968421

    Merge selected entries into your existing lists; do not replace a live mod list with this example. Click Save.

  4. 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.

  • 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.

Host your own Project Zomboid server

Play together on your own server

View servers