How to Add Mods to Your Project Zomboid Dedicated Server in 2026

How to Add Mods to Your Project Zomboid Dedicated Server in 2026

Vanilla Project Zomboid is an incredible survival simulation, but the Steam Workshop modding community elevates the game to a masterpiece. From expansive firearm overhauls like Brita's Weapons to massive custom maps like Raven Creek and Bedford Falls, mods are essential for keeping a long-term multiplayer server exciting.

However, installing mods on a Project Zomboid dedicated server is incredibly notorious for causing headaches. A single typo in your server configuration file can lock players out with a "Workshop Item Version Differ" error, or worse, permanently corrupt the map. In this comprehensive 2026 guide, we break down exactly how to install, order, and maintain mods on your hosted server.

The Two Critical INI Variables

To integrate mods on a dedicated server (like those running on Supercraft), you do not download the files manually via FTP. Instead, you instruct the server to download them directly from Steam during boot.

In your server's configuration directory (usually `/Zomboid/Server/`), open your servertest.ini file. You are looking for two specific lines:

• Mods= (The internal Mod IDs)
• WorkshopItems= (The Steam Workshop IDs)

Both lines must be populated accurately. The WorkshopItem ID tells the server what file to download from Steam. The Mod ID tells the server which specific mod packet within that download to activate.

Finding the IDs

Navigate to the mod you want on the Steam Workshop (e.g., "KI5's 1993 Ford F-350"). Scroll to the very bottom of the description. The author will always list the IDs:

Mod ID: 93fordf350
Workshop ID: 2933758364

If you are adding multiple mods, separate them cleanly with semi-colons (;) and no spaces.

Mods=93fordf350;TsarMotorHome;BritaWeaponPack
WorkshopItems=2933758364;2392987599;2200148440

Installing Custom Map Mods (The Tricky Part)

Adding vehicle and weapon mods is easy. Adding complex map mods (like Blackwood or West Point Expansion) requires a third step, as you must explicitly tell the server to stitch the new map files into the vanilla Knox Country.

Locate the Map= line in your servertest.ini. The order here is critical. The vanilla map `Muldraugh, KY` must ALWAYS be at the very end of the list, as the server reads from left to right. Custom maps load their chunks on top of the base map.

Map=RavenCreek;Blackwood;Muldraugh, KY

Note: If the map mod author specifies a specific spawn region folder, you must exactly type that folder name inside the `Map=` line.

Fixing the "Workshop Item Version Differ" Error

This is the most common error in Project Zomboid multiplayer. It happens when a mod author updates a mod on Steam, but your dedicated server is still running the old version, while the connecting player's client automatically downloaded the new version.

The Solution:

1. Log into your hosting control panel.
2. Completely shut down the Project Zomboid server.
3. Restart the server. Upon boot, the server engine will check the Steam Workshop API, notice an update is available, and automatically pull the fresh files before opening the port to players.

To prevent this from occurring randomly while players are online, it is highly recommended to schedule an automated server reboot every 12 to 24 hours.

Handling Mod Dependencies

If you install 'Brita's Armor Pack', you must also install 'Arsenal(26) GunFighter Mod' and 'ModOptions', as Brita relies on their backend code to function. If you include the child mod in your INI but forget the dependency, the server will either crash instantly or produce infinite red error boxes in the bottom right corner of the screen.

Always verify your mod load order recursively against the "Required Items" sidebar on Steam Workshop.

The Easier Way: 1-Click Modding

Manually editing semi-colons into a massive text file for a 150-mod pack is incredibly tedious and highly prone to human error (a single misplaced comma will break the entire list).

If you host with an elite provider like Supercraft, you can bypass this entirely. Supercraft’s specialized Project Zomboid panel features an intuitive Mod Manager API. You simply paste the Workshop URL into the panel, and it automatically extracts the Mod ID, Workshop ID, and Map names, automatically formatting your INI file flawlessly behind the scenes.

Conclusion

Mods transform Project Zomboid from a great game into an endlessly replayable phenomenon. As long as you carefully manage your `servertest.ini`, respect dependency chains, and place the vanilla map at the end of your map string, you can sculpt the exact zombie apocalypse your community desires.

Don't waste hours chasing INI syntax errors. Start customizing your apocalypse instantly by grabbing a dedicated Project Zomboid server from Supercraft today.