Guides

How to Add Steam Workshop Mods to a Project Zomboid Server

SkailarHost Team
November 15, 2026
7 min read
How to Add Steam Workshop Mods to a Project Zomboid Server

Project Zomboid's Steam Workshop has thousands of mods, from new cars and guns to whole new towns. Adding them to a dedicated server is simple once you know the one thing that trips everyone up: every mod has two different IDs, and the server needs both.

TL;DR

Stop the server and open its settings file, servertest.ini by default. Add each mod's Workshop ID (the number in its Workshop URL) to WorkshopItems= and its Mod ID (listed on the Workshop page) to Mods=, separated by semicolons. Map mods also go in Map=, before Muldraugh, KY. Start the server and it downloads everything; players get the mods automatically when they join.

Workshop ID vs Mod ID

DetailWorkshop IDMod ID
What it isThe Steam Workshop itemThe mod inside that item
Looks likeA number: 1234567890A name: ExampleMod
Where to find itAt the end of the Workshop page's URL (?id=…)At the bottom of the Workshop description, or in the mod's mod.info
Goes inWorkshopItems=Mods=

The Workshop ID tells the server what to download. The Mod ID tells it what to turn on. Most mod pages list both at the bottom of the description, as Workshop ID: and Mod ID:.

One Workshop item can contain several mods: a main mod with optional add-ons, or separate versions for different builds of the game. List the Workshop ID once, then only the Mod IDs you want to turn on.

Find your server's settings file

A Project Zomboid server reads its settings from an .ini file named after the server: servertest.ini, unless you changed the server name. It's in the Server folder of the server's Zomboid data folder, next to servertest_SandboxVars.lua (the sandbox settings) and servertest_spawnregions.lua. Edit it in the panel's file manager or over SFTP.

How to add Workshop mods, step by step

1. Stop the server

A running server can write over its settings file, so stop it before you edit anything.

2. Collect the IDs, and the requirements

For each mod, note its Workshop ID and Mod ID. Then check the Required items box on its Workshop page: those are other mods it needs, and they need both IDs too.

3. Add them to the ini file

Find the WorkshopItems= and Mods= lines and add your IDs, separated by semicolons without spaces:

WorkshopItems=1234567890;2345678901;3456789012
Mods=ExampleLibrary;ExampleMod;ExampleMod_Addon

Mods load in the order the Mods= line lists them, so put libraries first and add-ons or patches after the mods they change. The order of WorkshopItems= doesn't matter.

4. Start the server

The server downloads every Workshop item before it finishes starting, so the first start after adding mods takes longer. Watch the console for errors that name a mod.

5. Join the game

Players don't need to subscribe to anything. When they connect, the game downloads the server's mods for them, so the first join takes a little longer too.

Build 42 vs Build 41

Mods made for Build 41 don't work on Build 42, and the other way around. The server and every player have to be on the same build, and the server only loads mods made for the build it runs.

  • Check the version. Many popular mods have separate versions for each build, either as separate Workshop items or as separate Mod IDs in the same item. The Workshop page says which is which.
  • Match the format in your file. Build 42 can write each Mod ID with a backslash in front, like \ExampleMod. If your Mods= line already lists mods that way, add new ones the same way.

Adding map mods

Map mods need a third line. Find the map's folder name on its Workshop page (usually listed as Map Folder) and add it to the Map= line, before the vanilla map:

Map=ExampleTown;Muldraugh, KY

Muldraugh, KY always stays last. Map mods still need their Workshop ID and Mod ID on the other two lines, too. On an existing save, new map areas only appear in parts of the world nobody has explored yet, because areas players have visited are already saved.

Or skip the ini: one-click mods on SkailarHost

On our Project Zomboid server hosting, you can install Steam Workshop mods with one click from the control panel, manage mod collections and keep everything updated, without touching the ini. Build 42 is supported, and daily backups protect your save. Plans start at $8.99/month, and the most popular 20 GB plan handles 32–64 players.

When a mod updates

When a mod gets an update on the Workshop, players who download the new version can't join a server that is still on the old one: they get an error saying a Workshop item doesn't match the server's. Restart the server and it downloads the latest versions.

Troubleshooting

  • A mod downloads but doesn't load: its Mod ID is missing from Mods= or spelled differently. Copy it exactly, capitals included.
  • A mod never downloads: its Workshop ID is missing from WorkshopItems=, or the item is private or friends-only, which the server can't download.
  • The server crashes after you add mods: take out the last mods you added, start again and read the console. Check each mod's required items, and that it's made for your build.
  • A map doesn't show up: check that it's in Map= before Muldraugh, KY, and that you're looking at an area nobody had explored yet.
  • Players can't join: restart the server so its mods are up to date, and make sure everyone is on the same build.

⚠️ Removing mods from a running save

If you remove a mod, the items, vehicles and buildings it added can break or disappear from your world. Take a backup before you remove one, so you can roll back.

FAQ

Can I use a Workshop collection?

Not directly: the ini file has no setting for collections, so every item's IDs have to be listed one by one. Our control panel can manage collections for you.

Do players need to subscribe to the mods?

No. The game downloads the server's mods for them when they join.

Can I add mods to an existing world?

Usually, yes. Most mods work on an existing save, but map mods only change unexplored areas and some big overhauls ask for a new save. Back up first either way.

How many mods can a server run?

There's no fixed limit, but every mod adds memory use and startup time. Big mod lists need more RAM, and you can upgrade your plan later without losing your save.

Survive together on your own server

Project Zomboid servers from $8.99/month, with Build 42 support, one-click Workshop mods, daily backups and free DDoS protection.

Tags

#Project Zomboid#Steam Workshop#Mods#Build 42#Guides

Related Articles