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
- Go to the mod's page on the Steam Workshop for Project Zomboid.
- The Workshop ID is the number in the URL after
id=:
https://steamcommunity.com/sharedfiles/filedetails/?id=2200148440 - 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)
- On the manage page, click the
Settings tab. - In Workshop Items, enter your Workshop IDs separated by semicolons. e.g.
2200148440;2313387159 - In Mods, enter your Mod IDs separated by semicolons. e.g.
Brita;Brita_2 - 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 Name | Mod ID | Workshop ID | What it does |
|---|---|---|---|
| Brita's Weapon Pack | Brita | 2200148440 | Hundreds of new firearms and attachments. |
| Brita's Armor Pack | Brita_2 | 2460154811 | Matching armor and clothing for Brita's weapons. |
| Raven Creek | RavenCreek | 2196102849 | Large extra city map with dense urban loot. |
| Superb Survivors | SuperbSurvivors | 1905148104 | Adds NPC survivors that can follow, trade, and fight. Single-player only. |
| Arsenal[26] GunFighter Mod [2.0] | Arsenal(26)GunFighter[MAIN MOD 2.0] | 2297098490 | Overhauled firearms handling and reloading mechanics. |
| More Description for Traits | MoreDescriptionForTraits4166 | 2685168362 | Adds detail to perk/trait descriptions. |
| Tsar's Common Library 2.0 | tsarslib | 2392709985 | Required dependency for Autotsar Trailers and other Tsar mods. |
| Autotsar Trailers | autotsartrailers | 2282429356 | Adds towable trailers to vehicles. Requires Tsar's Common Library. |
| Better Sorting | BetterSortCC | 2313387159 | Improves the inventory sorting system. |