🔧 Installing Steam Workshop Mods

The easiest way to add mods is through the Settings tab on your manage page - no config file editing required.

🚨 RAM Warning: Each mod adds to RAM consumption. With the free 4 GB allocation, you can run 5-10 light mods comfortably. Very large overhaul mods (like Arsenal, Bedford Falls) may crash the server. Monitor RAM on your dashboard.

Step 1: Find the Workshop ID and Mod ID

  1. Go to the mod's page on the Steam Workshop for Project Zomboid.
  2. The Workshop ID is the number in the URL after id=:
    https://steamcommunity.com/sharedfiles/filedetails/?id=2200148440
  3. The Mod ID is the internal name the game uses to load the mod (e.g. Brita). It's different from the Workshop ID.

💡 Shortcut: Most Workshop items list both the Mod ID and Workshop ID at the bottom of their Steam description page. Scroll to the bottom before searching anywhere else.

💡 The Workshop ID is used to download the mod. The Mod ID is used to load it. You need both.

Step 2: Add Mods via the Settings Tab (Recommended)

  1. On the manage page, click the 🔩 Settings tab.
  2. In Workshop Items, enter your Workshop IDs separated by semicolons. e.g. 2200148440;2313387159
  3. In Mods, enter your Mod IDs separated by semicolons. e.g. Brita;Brita_2
  4. Click Save Changes, then restart the server.

👥 Sub users with access to your server can add mods this way too - no file editing or Pterodactyl needed.

Step 3: Config Format (for reference)

When using the Settings tab the fields are saved automatically. If you ever need to edit the raw file, multiple mods are separated by semicolons ;:

# Example with two mods
Mods=Brita;Brita_2
WorkshopItems=2200148440;2460154811

ℹ️ The order in Mods matters if mods have dependencies. Put dependency mods before the mods that need them. Match the same order in both Mods and WorkshopItems.

Step 5: Client-Side (Your Friends Too!)

Players connecting to a modded server also need the same mods installed on their client. They can either:

  • Subscribe to the same Workshop item(s) on Steam before joining (recommended).
  • Some mods are server-side only - check the mod description.

Finding Mod IDs Quickly

The quickest source is the bottom of the mod's Steam Workshop page - most authors list the Mod ID and Workshop ID there. If not, subscribe to the mod, let it download, then check:

C:\Users\YOU\Zomboid\mods\mod-name\mod.info

Open that file and look for the line: id=MODID

Recommended Starter Mods

Mod NameMod IDWorkshop IDWhat it does
Brita's Weapon PackBrita2200148440Hundreds of new firearms and attachments.
Brita's Armor PackBrita_22460154811Matching armor and clothing for Brita's weapons.
Raven CreekRavenCreek2196102849Large extra city map with dense urban loot.
Superb SurvivorsSuperbSurvivors1905148104Adds NPC survivors that can follow, trade, and fight. Single-player only.
Arsenal[26] GunFighter Mod [2.0]Arsenal(26)GunFighter[MAIN MOD 2.0]2297098490Overhauled firearms handling and reloading mechanics.
More Description for TraitsMoreDescriptionForTraits41662685168362Adds detail to perk/trait descriptions.
Tsar's Common Library 2.0tsarslib2392709985Required dependency for Autotsar Trailers and other Tsar mods.
Autotsar Trailersautotsartrailers2282429356Adds towable trailers to vehicles. Requires Tsar's Common Library.
Better SortingBetterSortCC2313387159Improves the inventory sorting system.