How do I install mods onto my Vintage Story server?

Vintage Story allows you to install mods on your server, allowing you to experience the game differently.

Installing Mods on AleForge

Using the Blacksmith’s Portal

1. Download the mod from the official Vintage Story mod database and make sure it matches your server’s game version. Leave the file as a .zip and do not unzip it.
2. Open the Blacksmith’s Portal, select your server, and stop it.
3. Go to Files and open data/Mods.
4. Upload the .zip file into data/Mods. Do not upload mods to the top-level Mods folder in Files (that folder is for built-in game files and has a notice telling you not to add mods there).

If data/Mods isn’t there yet, start your server once so it generates its folders, wait for it to finish loading, stop it, and then upload your mods.

5. Start your server. You’ll see each mod listed in the console as it loads, and players will be prompted to download any required mods when they join.

Vintage Story doesn’t reload mods while the server is running. Whenever you add, remove, or update a mod, stop the server first and start it back up after uploading.

Self-Hosting/Other Providers

1. Download the mods you’d like to use from the official Vintage Story modding website
2. Find where your Vintage Story server is installed
3. Open the Mods folder, if it is not already there you can create this folder
4. Place your downloaded .zip file here
5. Restart your server