Saltar al contenido principal

Installing Mods on a Project Zomboid Server

Each mod requires two values:

  • Workshop ID — the numeric identifier of the Steam Workshop item;
  • Mod ID — the internal name loaded by Project Zomboid.

A single Workshop item can contain multiple Mod IDs.

Before installing a mod, open Startup and check Steam Beta Branch. An empty field means the current stable version; a branch name means that version is selected. Check the mod page to confirm that it supports the same game version or branch and note every required dependency. A Build 41 mod may not work on Build 42 and vice versa.

1. Stop the server​

Stop the server in the Mikasa Host panel before editing its configuration.

2. Find the Workshop ID and Mod ID​

Open the mod in the Steam Workshop. Authors usually list its Workshop ID, Mod ID, and dependencies in the description.

The Workshop ID also appears after ?id= in the page URL:

https://steamcommunity.com/sharedfiles/filedetails/?id=2313387159

The Workshop ID in this example is 2313387159.

If the author does not list the Mod ID, download the item on your computer and open:

Steam/steamapps/workshop/content/108600/{WorkshopID}/mods/{ModName}/mod.info

Use the value after id=. If the item contains multiple components, add every required Mod ID.

3. Open the active server file​

The active Server Name is shown on the Startup tab.

ServerName

Open this file in the file manager:

.cache/Server/{ServerName}.ini

For example, the default name uses .cache/Server/mikasa.host.ini. If Server Name was changed, edit the file matching the new name.

4. Add the Workshop IDs and Mod IDs​

Find WorkshopItems= and Mods=. Separate multiple values with semicolons:

Mods=BetterSortCC
WorkshopItems=2313387159

Keep dependencies and main mods in the order required by their authors. Do not put numeric Workshop IDs in Mods=; that line requires internal Mod IDs.

For a large public collection, use this collection ID generator to obtain the Workshop IDs. You must still verify the Mod IDs in each description or mod.info file.

5. Save the file and start the server​

The server downloads the Workshop items and loads the configured mods during startup. Project Zomboid prompts joining players to download missing Workshop items.

If the mods do not load​

  • Make sure you edited the .ini belonging to the active Server Name.
  • Match the server version to the versions supported by the mod and install every required dependency.
  • Do not confuse the numeric Workshop ID with the Mod ID.
  • Read the console error to identify the missing Workshop ID or Mod ID.
  • If a large collection fails, start with one mod and add the remaining entries incrementally.

Can mods be added to an existing world?​

Yes. Most mods can be enabled in an existing world, but maps and mods that generate new areas or world data may require additional steps. Follow the installation notes on the Workshop page.