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.
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.
- Go to the Steam Workshop page for the mods you want to add.
- Locate the Workshop ID, which is the string of numbers found at the end of the URL.
- 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.txtfile located at\Steam\steamapps\workshop\modID\mods\modName\info.txt.
Step 2: Locate the Configuration File
Next, we will open the file where these IDs need to be pasted.
- Log into your MintServers panel and click the Stop button to ensure your server is offline before making changes.
- On the left-hand sidebar, click the Files tab to open your File Manager.
- Navigate to the following path:
.cache > server > mintservers.ini - Click on mintservers.ini to open and edit the file.
📁 .cache (main server directory)
📁 server
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.
- Find the line that says WorkshopItems= and paste your numeric Workshop IDs there.
- 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.
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.