How to Add Mods to Your Vintage Story Server

Updated June 10, 2026 · By Host Havoc Technical Support Team

Vintage Story supports mods through the built-in mod database as well as manual file uploads. You can install mods using either method depending on what is available for the mod you want.

Method 1: Install via the Web Console

This method works for mods listed in the Vintage Story mod database.

  1. Log into the Game Control Panel and navigate to your server.
  2. Start the server and wait for it to fully load.
  3. Click the Web Console icon in the left sidebar.
  4. Run the following command, replacing ModID with the mod's identifier:
/moddb install ModID

The ModID is typically the mod name without spaces, and matches the last segment of the mod's URL. For example, for https://mods.vintagestory.at/primitivesurvival, the ModID is primitivesurvival.

Method 2: Upload manually via FTP or File Manager

Use this method for mods that are not in the mod database or that you downloaded as a .zip file.

  1. Locate the mod's .zip file on your computer.
  2. Connect to your server using the File Manager in the Game Control Panel or via FTP.
  3. Upload the .zip file to the Mods folder on the server.
  4. Restart the server for the mod to load.

Troubleshooting

  • If a mod does not load after installation, confirm the server was fully restarted and that the mod version is compatible with your Vintage Story server version.
  • Use FTP to remove a mod's .zip file from the Mods folder if you need to uninstall it.