Project Zomboid: Adding Mods to Dedicated Servers
Modding **Project Zomboid** is essential for a long-term server. Whether you are adding new maps like **Raven Creek**, vehicle packs like **Filibuster Rhymes**, or quality-of-life tweaks, the process involves two critical identifiers: the **Workshop ID** and the **Mod ID**.
1. The Two ID System
Every mod has a Workshop ID (for downloading from Steam) and a Mod ID (for loading into the game engine). You must add BOTH to your server config.
2. Mod Collections
Instead of adding 100 mods one by one, experts use Steam Collections. This ensures all players download the exact same list with one click.
3. Map Mods
Adding maps requires an extra step. You must add the map folder name to the Map= line in your configuration before "Muldraugh, KY".
How to Manually Add a Mod
Let's use the popular mod "Better Sorting" as an example.
- Go to the mod's Steam Workshop page.
- Scroll to the bottom of the description to find the IDs.
- Workshop ID:
2313387159 - Mod ID:
BetterSorting
- Workshop ID:
- Open your **Supercraft Control Panel** and go to Advanced Server Settings (or edit
servertest.ini). - Paste the Workshop ID into the
WorkshopItems=line. Use semi-colons to separate multiple IDs.
Example:WorkshopItems=2313387159;123456789 - Paste the Mod ID into the
Mods=line.
Example:Mods=BetterSorting;AnotherMod - Save and Restart the server.
Troubleshooting Mod Errors
| Error Message | The Fix |
|---|---|
| Workshop Item Version Mismatch | The server and the player have different versions of the mod. The server owner must Restart to trigger an update, or the player must unsubscribe/resubscribe on Steam. |
| Map Not Loading | You likely forgot to add the Map= line or placed "Muldraugh, KY" first. Custom maps must always be listed first. |
| Item Not Found | You added a mod to an existing save that alters loot tables. While most items work, some features may only spawn in newly explored areas. |
Pro Tip: Using a mod manager like "Mod Manager: Server" (Mod ID: ModManagerServer) inside the game can generate the text string for you! enable your mods in the main menu, then copy the Mods= and WorkshopItems= strings it generates into your server panel.
Build the ultimate survival experience. Host your Project Zomboid server with Supercraft and enjoy automated mod updates and one-click backups.