How to Add Mods to Your Project Zomboid Server

Project Zomboid · 79 views · Updated 1 hour ago

Adding Steam Workshop Mods

Project Zomboid supports Steam Workshop mods on dedicated servers. Mods are downloaded automatically when your server starts.

Finding the Workshop ID and Mod ID

Every mod has two IDs — you need both:

  • Workshop ID — the number in the Steam Workshop URL (e.g., 2392709985 from steamcommunity.com/sharedfiles/filedetails/?id=2392709985)
  • Mod ID — the internal name defined by the mod author (e.g., tsarslib). This is found on the mod Workshop page description, or inside the mod files under mod.info

These are different. The Workshop ID is always a number. The Mod ID is usually a text name. Do not put the Workshop ID in both fields.

How to Add Mods

  1. Find the mod on the Steam Workshop
  2. Copy both the Workshop ID (from the URL) and the Mod ID (from the description)
  3. In your game panel, go to the Startup tab
  4. Add the Workshop ID to the Workshop Mods field (separate multiple IDs with semicolons: 2392709985;2313387159)
  5. Add the Mod ID to the Mods field (separate with semicolons: tsarslib;SuperbSurvivors3)
  6. Restart the server — mods will download automatically on first start. This may take a few minutes depending on mod sizes

Map Mods

If you are adding a map mod (like Bedford Falls or Raven Creek), you also need to add the map name to the Map field in your server settings, in addition to the Workshop and Mod IDs.

B42 Mod Compatibility

Build 42 overhauled many game systems. Not all B41 mods are compatible with B42. Before adding mods:

  • Check the mod Workshop page for a B42 compatibility note from the author
  • If the mod was last updated before B42 release, it may not work
  • Using incompatible mods can prevent your server from starting

Troubleshooting

  • Server does not start after adding mods — remove the most recently added mods and try again. Add them back one at a time to find the incompatible one
  • Mod not loading — verify the Mod ID matches exactly what the author specified (case-sensitive)
  • High RAM usage — each major mod adds significant memory usage. Monitor your RAM in the panel after adding mods
  • Mod load order — some mods depend on other mods being loaded first. Check the mod description for required dependencies and add them in the correct order

Only consider upgrading your plan if your server is clean, properly configured, and still consistently hitting resource limits under normal load.

Still need help?

Create a Support Ticket

Related Articles