Summer Sale   25% off with code 00d 00h 00m 00s


 
 
 
 
Knowledgebase Project Zomboid How to Install Mods on Project Zomboid

How to Install Mods on Project Zomboid

Adding mods to your Project Zomboid server is a great way to customize your survival experience! You will just need to gather some IDs from the Steam Workshop and add them to your server configuration file.

Let us walk through your MintServers game panel and get your mods installed.

💡 Prefer the easy way?
We highly recommend using our 1-Click Mod Installer. It automatically handles all file syncing and configuration for you, so you don't have to edit any files manually. Check out our Guide to the Project Zomboid 1-Click Installer if you prefer to save time!

Step 1: Find Workshop and Mod IDs

First, you need to find the specific IDs for the mods you want to install.

  1. Go to the Steam Workshop page for the mods you want to add.
  2. Locate the Workshop ID, which is the string of numbers found at the end of the URL.
  3. Locate the Mod ID, which is the internal name of the mod. You can usually find this in the mod description or inside the mod's info.txt file located at \Steam\steamapps\workshop\modID\mods\modName\info.txt.
🚀 Launch Your Unlimited RAM Game Server — Just $9.99/mo!

Step 2: Locate the Configuration File

Next, we will open the file where these IDs need to be pasted.

  1. Log into your MintServers panel and click the Stop button to ensure your server is offline before making changes.
  2. On the left-hand sidebar, click the Files tab to open your File Manager.
  3. Navigate to the following path: .cache > server > mintservers.ini
  4. Click on mintservers.ini to open and edit the file.
📁 .cache (main server directory)
📁 server
📄 mintservers.ini (Click to edit this file)
ℹ️ Important Note:
Unlike some other hosts, MintServers specifically uses the mintservers.ini file instead of servertest.ini. Make sure you are editing the correct one!

Step 3: Add the Mod IDs

Now it is time to add your mods to the configuration file.

  1. Find the line that says WorkshopItems= and paste your numeric Workshop IDs there.
  2. Find the line that says Mods= and paste your Mod IDs (the names) there.

If you are adding multiple mods, separate each ID with a semicolon ;. Do not use any spaces.

📄 mintservers.ini
WorkshopItems=2619072426;2392709985

Mods=tsarslib;commonSense

Step 4: Save and Restart

Once you have added all your mods, click the Save Content button in the editor. Then, head back to your Console and Start your server so the changes take effect and the mods begin downloading.

🛠️ Troubleshooting Mod Issues

Server crashes or players cannot join: This usually happens if there is a mismatch between the WorkshopItems line and the Mods line. Make sure you did not include spaces between your semicolons, and verify that the order of the mods matches on both lines.

If your server still has trouble loading mods, open a support ticket and our team will gladly help you resolve the configuration together.

Was this article helpful?

The Last Minecraft Hosting You Will Ever Need!

Unlimited Slots, Unlimited RAM, One-Click Mods & Plugins