Project Zomboid Tutorials

How to Add Mods to Your Project Zomboid Server

Install Steam Workshop mods on your Project Zomboid server by adding Workshop IDs and Mod IDs to your server config file.

Last updated: April 3, 2026

4.9

511+ Satisfied Customers

Install Steam Workshop mods on your Project Zomboid server by adding their IDs to your server config file. You need two pieces of information for each mod: the Workshop ID (numeric) and the Mod ID (text name).

Get Your Mod IDs and Workshop IDs

The fastest way to get both IDs for an entire mod collection is to use the Project Zomboid Mod ID Grabber.

  1. Open the PZ Mod ID Grabber
  2. Paste your Steam Workshop collection URL (or individual mod URL)
  3. Click Grab IDs
  4. Copy the Mod IDs output and the Workshop IDs output

Edit Your Server Config

  1. In the Game Panel, go to Management → File Manager
  2. Navigate to /Zomboid/Server/
  3. Open the file named <server-name>.ini (your server name defaults to WinterNode if you haven’t changed it)
  4. Find the WorkshopItems= line
  5. Paste your Workshop IDs, separated by semicolons
  6. Find the Mods= line
  7. Paste your Mod IDs, separated by semicolons
  8. Click Save

Format by Build Version

The format for the Mods= line changed in Build 42. Make sure you use the correct format for your server version.

Build 42 (current)

Each Mod ID must be prefixed with a backslash (\).

Mods=\ModNameA;\ModNameB;\ModNameC
WorkshopItems=111111;222222;333333

Build 41

Mod IDs are listed without any prefix.

Mods=ModNameA;ModNameB;ModNameC
WorkshopItems=111111;222222;333333

Apply Your Changes

  1. Go back to your server’s main page in the Game Panel
  2. Click Restart
  3. Wait for the server to show as Online. The first restart after adding mods may take longer as the server downloads workshop items

Your mods should now be active. Players will be prompted to download the required mods when they connect.

Troubleshooting

Mods not loading

  • Check your separators. Use semicolons (;), not commas.
  • Check the build format. Build 42 requires \ before each Mod ID.
  • Check both lines. WorkshopItems= tells Steam what to download. Mods= tells PZ what to activate. You need both.
  • Check for typos in Mod IDs. Mod IDs are case-sensitive. bettersortcc is not the same as BetterSortCC.

Finding a Mod ID manually

If the Mod ID Grabber can’t detect a mod’s ID automatically:

  1. Subscribe to the mod on Steam Workshop
  2. Open the mod folder at Steam/steamapps/workshop/content/108600/<WorkshopID>/
  3. Find the mod.info file inside the mod’s subfolder
  4. The id= line contains the Mod ID you need

Still not working?

If your mods still aren’t loading after checking the above, contact our support team with:

  • Your server name
  • The contents of your Mods= and WorkshopItems= lines
  • Any error messages from the server console

Frequently Asked Questions

Always semicolons. Both the Mods= and WorkshopItems= lines use semicolons (;) as separators. Commas will not work and your mods will fail to load.

The Workshop ID is the numeric Steam identifier (the number in the mod's Steam URL, like 2313387159). The Mod ID is the text name defined by the mod author in the mod's mod.info file (like BetterSortCC or tsarslib). Your server needs both: WorkshopItems tells Steam what to download, Mods tells PZ what to activate.

The most common causes are: using commas instead of semicolons, missing the Mods= line (Workshop IDs alone are not enough), or using the wrong format for your build version. Build 42 requires a backslash before each Mod ID.

Yes. After editing your server .ini file, restart your server for the changes to take effect. The server will download the workshop items on startup.

Back to Help Center Get Project Zomboid Hosting