How to Install Mods on a Dedicated Server
Installing mods on a Project Zomboid server requires editing your configuration file to include two pieces of information for every mod: the Workshop ID (for downloading) and the Mod ID (for loading).
Step 1: Get the Mod Info
Go to the Steam Workshop page for the mod you want to install. Scroll down to the description. You will usually find the IDs at the bottom.
Example for "Fluffy Hair":
- Workshop ID: 2447729538
- Mod ID: FH
Step 2: Edit servertest.ini
Navigate to your server's configuration file (usually servertest.ini or located in your specialized hosting panel).
You need to edit two lines. IMPORTANT: Use semicolons ; to separate multiple mods.
1. WorkshopItems
This tells SteamCMD which files to download and update.
WorkshopItems=2447729538;2402057349;123456789
2. Mods
This tells the game server which mods to actually load into the world.
Mods=FH;Tsarslib;AnotherModName
Step 3: Mod Load Order
The order in the Mods= line matters significantly.
- Maps First: Map mods (like Bedford Falls, Raven Creek) often need to be loaded before other mods.
- Libraries First: Dependency mods (like Tsarslib) must originate before the mods that use them.
- Example:
Mods=Tsarslib;TrueActionsDancing;rv_interior
Step 4: Map Mods (Special Case)
If you are installing a map mod, you must ALSO add the map folder name to the Map= line in your config. Muldraugh, KY must always be last.
Correct:
Map=BedfordFalls;North;Muldraugh, KY
Common Mistakes
| Mistake | Consequence |
|---|---|
| Missing Workshop ID | Server won't download the file. "Client has mod that server does not" error. |
| Missing Mod ID | Server downloads the file but doesn't use it. Nothing changes in game. |
| Wrong Separator | Using commas , instead of semicolons ; breaks the list. |
| Spaces | Do not put spaces between IDs (e.g., ID; ID). Keep them tight: ID;ID. |