What is the difference between a Mod ID and a Workshop ID?

The Workshop ID is the number in the Steam Workshop URL, and it goes in WorkshopItems= so SteamCMD downloads the item. The Mod ID is a short text name defined inside the mod's mod.info file, and it goes in Mods= so the game loads it. A mod needs to be in both lines to work.

Where do I find a mod's Mod ID?

Most authors list it in the Workshop item description as "Mod ID: something". If it is not there, download the item and look in its mod.info file for the id= line. Items that bundle several mods list several Mod IDs, and all of them go in the Mods= line.

Does the order of mods matter?

Yes, for dependencies. If mod B requires mod A, then A must come before B in the Mods= line or B will fail to load. Load order also decides which mod wins when two of them change the same thing, with later entries taking priority.

Do Build 41 mods work on a Build 42 server?

No. Build 42 rewrote the modding framework, so Build 41 mods do not work on a Build 42 server. Workshop IDs are not version aware, so SteamCMD will still download them and the server will still start, which makes this easy to miss. Rebuild the list against Build 42 versions of each mod.

My mods download but do not load. Why?

Almost always a missing or misspelled Mod ID in the Mods= line, since the download is driven by WorkshopItems= alone. Check the server console on startup: it logs each mod it loads, so anything in WorkshopItems= that never appears there is missing from Mods= or has the wrong ID.

MOD LIST BUILDER

Project Zomboid Mod List Builder

Paste Steam Workshop links and get the paired Mods= and WorkshopItems= lines for your Project Zomboid server config, in the right format and the right order.

Paste Workshop links, IDs, or a copied item description

One per line or all at once. We pull the Workshop ID out of any link, and if you paste a single item description we also pick up its "Mod ID:" line.

Project Zomboid needs two different values per mod. WorkshopItems= takes the numeric Workshop ID from the URL, which downloads the item. Mods= takes the internal mod ID from the item's mod.info, which actually loads it. They are not the same string, and a mod listed in only one of the two lines silently does nothing.

Your mods (0)

Nothing added yet. Paste a Workshop link above to start building your list.

Your config lines

Mods

Mods=

WorkshopItems

WorkshopItems=

Both lines go in servertest.ini, or the .ini file named after your server, which you can edit from the Config tab of your game panel or over FTP.

How the mod list works

Every Project Zomboid mod needs to appear in two places in your server config. WorkshopItems= is a semicolon-separated list of numeric Workshop IDs, and it controls what SteamCMD downloads to the server. Mods= is a semicolon-separated list of internal mod IDs, and it controls what the game actually loads at startup.

The two values are different, and the mod ID is not derivable from the Workshop ID. Mod authors publish it in the item description, usually as a line reading "Mod ID: something". A single Workshop item can also contain several mods, each with its own mod ID, in which case all of them belong in the Mods= line while the item appears once in WorkshopItems=.

Order matters when mods depend on each other: a dependency has to be listed before the mod that needs it in the Mods= line. Use the arrows on each row to set the order before you copy, and if a mod page lists required items, put those first. Load order also decides which mod wins when two of them change the same thing, with later entries taking priority.

Frequently asked questions Find answers to common questions about our server hosting.

Any more questions?

View Knowledgebase

Run your mod list on a real server

Rent a Project Zomboid server with Build 42 installed by default, a Steam Workshop tab, and a config editor built into the panel.

Instant Deployment DDoS Protection Free Backups

Server config generator RAM calculator