How to install mods on a Project Zomboid server?

Mods transform Project Zomboid: new weapons, vehicles, maps, survival mechanics, RP immersion… They install from the Steam Workshop and are declared in the server's configuration file. Here's how to do it, by hand and then in 1 click.

1. Choose your mods on the Steam Workshop

Browse the Steam Workshop for Project Zomboid and, for each mod, note down two pieces of information: the Workshop ID (the page's identifier) and the Mod ID (given in the description). Both are needed, and they are not the same.

2. Fill in servertest.ini

In servertest.ini, two lines manage the mods:

• WorkshopItems=: the list of Workshop IDs, separated by semicolons. This is what tells the server what to download.
• Mods=: the list of Mod IDs, in load order. This is what actually activates the mods in the game.

Watch out for the load order: some mods depend on others and must be listed after them in Mods=.

3. Restart and check

After saving servertest.ini, restart the server: it downloads the Workshop mods and then loads them. Check the logs to spot any missing or conflicting mod. Your players will need to subscribe to the same mods on the client side to connect.

Add mods in small batches and test: an incompatible mod can prevent the server from starting. If something goes wrong, remove the last one you added.

The 1-click version

The FlyPanel panel on our Project Zomboid servers lets you install Steam Workshop mods and update WorkshopItems= and Mods= without editing the files by hand. A real time-saver when you manage a community. Before adding mods, make sure your server is properly set up: see How to make a Project Zomboid server. Ready to get started? Discover our offers from 3,99 €/month.