GuavaHost
Language & currency
Client AreaGame Panel Toggle navigation
Navigation
PricingReviewsHelp CenterSupport
Games All Games
Minecraft Java $3.99/mo
Minecraft Bedrock $3.99/mo
Minecraft Geyser $3.99/mo
Rust $15.99/mo
RuneScape: Dragonwilds $5.99/mo
Palworld $9.99/mo
Valheim $5.99/mo
Valheim + BepInEx $5.99/mo
ARK: Survival Evolved $11.99/mo
ARK: Survival Ascended $17.99/mo
Project Zomboid $5.99/mo
Enshrouded $5.99/mo
Don't Starve Together $2.99/mo
7 Days to Die $12.99/mo
Counter-Strike 2 $2.99/mo
Terraria $2.49/mo
tModLoader $2.49/mo
Hytale $11.99/mo
Multi-Game Server $24.99/mo
Discord Bot Hosting $1.50/mo
Company
About UsFAQRefer to earnSLATerms of ServicePrivacy Policy
Language & currency
Client AreaGame Panel

Installing Steam Workshop Mods on Your Project Zomboid Server

Adding Steam Workshop mods to a Project Zomboid server means putting two values in your servertest.ini for every mod, the numeric Workshop ID on the WorkshopItems line and the text Mod ID on the Mods line, then restarting so the server downloads and loads them.

2 min read · Updated Sep 24, 2026 · By GuavaHost Team

Two IDs for every mod

Project Zomboid needs two different pieces of information for each mod, and this trips up almost everyone at first.

  • The Workshop ID is the number in the mod's Steam Workshop web address, the part after ?id=. This tells the server what to download.
  • The Mod ID is a short text name, like Brita_Weapons. It tells the game which mod inside that download to switch on. You will find it in the mod's Workshop description, and a single Workshop item can contain several Mod IDs.

Miss either one and the mod simply will not load, usually with no obvious error.

Add the mods to servertest.ini

  1. Open your server in the control panel and choose Server properties under Game tools in the server menu. Your servertest.ini is the Server settings (servertest) tab.
  2. Find the WorkshopItems setting (the search box helps) and add each Workshop ID, separated by semicolons.
  3. Find the Mods setting and add each Mod ID, again separated by semicolons.
  4. Click Save changes, then press Restart at the top of the server page.

You can also open the file itself on the Files tab. It is in the .cache/Server folder.

Your lines will look something like this:

WorkshopItems=2392709985;2657084703

Mods=Bandits;VFExpansion1

On the first restart the server downloads the mods from Steam, so give it a few minutes and watch the Console log.

Load order matters

Mods load from left to right in the order you list them on the Mods= line, and the last mod to touch something wins. As a rule, put framework and library mods first, then content mods, then any patches or compatibility mods that a mod author tells you to load afterwards. If two mods clash, changing their order is often the fix.

Map mods need one more line

Map mods also need a Map= line. Add the mod's map folder name before the base map, separated by semicolons, like this:

Map=MyCoolMap;Muldraugh, KY

Always keep Muldraugh, KY last so the base game map still loads.

Adding mods to a world already in progress

You can add mods to a running save, and most content mods, like new weapons or clothing, are safe to bolt on. Take a snapshot on the Backups page first, then add the mod and restart.

Be careful the other way around. Removing a mod mid-save can wipe the items or vehicles it added and, with map mods, can corrupt the chunks players have already explored. Avoid removing map mods once a world has used them. If a mod says it is not safe for existing saves, believe it and test on a fresh world first.

Check the console

After the restart, read the Console log. Missing Mod IDs, load-order clashes and failed downloads all show up there, which makes fixing them much faster than guessing.

Still stuck? Jump into our Discord at discord.gg/GuavaHost and the team will help you out.

  • project-zomboid
  • mods
  • steam-workshop
  • load-order

Host a Project Zomboid server From $5.99/mo, with instant setup and DDoS protection.

Still need help? Our team is online 24/7 to answer questions.

Contact support

Related guides

More from Project Zomboid.

  • Back up and restore a Project Zomboid save

    A Project Zomboid save is a world folder plus a player database, and a backup is only any use if it has both. Here is where they live, how to copy them cleanly, and how to roll back after a mod update ruins your world.

    6 min

  • Improve Project Zomboid server performance

    Why a Project Zomboid server stutters, what zombie population and respawn settings actually cost you, and the changes that cut the load without making the game feel different to play.

    6 min

  • How to Connect to Your Project Zomboid Server

    Connecting to your Project Zomboid server takes about a minute: grab the IP and port from your GuavaHost panel, add it under Join in the main menu, and enter your username and password to drop into the world.

    2 min

  • Project Zomboid Admin Commands: Become Admin

    To run your Project Zomboid server you log in as the admin user with your admin password, then you can open the admin panel or type slash commands like /additem, /kickuser and /setaccesslevel straight into chat.

    2 min

  • Editing Your Project Zomboid Server and Sandbox Settings

    Project Zomboid keeps its settings in two files, servertest.ini for server options like the name, password and player slots, and servertest_SandboxVars.lua for the world rules like zombie count and loot, and you edit both on the Server properties page of your control panel.

    2 min