We use cookies to enhance your browsing experience, serve personalized ads or content, and analyze our traffic. By clicking "Accept All", you consent to our use of cookies.
Articles in section
How to Add Mods to Your Vintage Story Server
Step-by-step guide to safely find, upload and install Vintage Story mods on your server, with backups, troubleshooting tips and dep checks.
Welcome to a new era of survival! Adding mods to your Vintage Story server is a fantastic way to introduce new mechanics, items, creatures, and challenges for you and your friends. Whether you are a veteran server administrator or setting up your very first modded world, customizing your game is a quick and straightforward process.
This guide will walk you through exactly where to find mods and how to safely install them onto your server.
Installing Your Mods Step-by-Step
Before making any modifications, it is always a good idea to back up your current world save just in case a mod conflicts with your existing data. Once you are ready, follow these steps:
Locate and download your desired mods. The official and safest place to browse is the Vintage Story Mod Database at this link: Vintage Story Mod Page.
Download the mod as a .zip file directly to your computer.
Alternatively, if you use the One-Click Install button inside your game client, simply locate that downloaded .zip file on your personal computer.
Log in to your server panel and go to Actions > Shutdown to completely stop your server. You should never modify server files while the game is running.
Navigate to your File Manager.
Open the Server/ folder, and then locate and open the Mods/ folder.
Upload your downloaded mod .zip file directly into this directory. Because most Vintage Story mods have very small file sizes, uploading them directly through the web File Manager is usually sufficient. You just need to drag and drop the .zip file on the upload bubble.
Go to Actions > Restart to boot your server back up. The server will automatically unpack and load the mods during startup!
Troubleshooting & Tips
If your server crashes on startup or your friends are having trouble joining your newly modded world, keep these quick troubleshooting fixes in mind:
Do Not Extract the Zips: The Vintage Story engine is designed to read the .zip files directly. If you extract the folder and upload the raw files, the server will not recognize the mod.
Version Mismatch: Mods break frequently when the core game updates. Always check the Vintage Story Mod Database to ensure the mod you downloaded is compatible with the exact version of the game your server is running.
Client Side Downloads: When your friends try to connect to your modded server, the game should automatically prompt them to download the required server mods. However, if they have an outdated version of that same mod already installed on their local PC, it can cause a connection rejection. Have them clear their local mod folder if they cannot join!
Check Dependencies: Some larger mods require smaller core mods (like an API or a specific library) to function. Always read the mod description carefully to ensure you aren't missing a required dependency.
Conclusion
Modding Vintage Story breathes entirely new life into your multiplayer experience. By dropping your .zip files into the correct Mods directory, you guarantee a stable, endlessly customizable world for your entire community to enjoy.
If you encounter any issues or have further questions, feel free to contact our support team for assistance!
