How to Add Mods to Your Vintage Story Server

Updated 31 October 2026 · By Host Havoc Technical Support Team

There are a few ways to add mods to your Vintage Story server. Our HH Mod Manager (recommended) lets you browse the Vintage Story Mod DB and install mods right from the panel.

  1. Log in to the Game Control Panel and navigate to your server.
  2. Click the HH Mod Manager icon.
  3. Open Browse Mod DB. Search for a mod, or pick a category and a sort order. The game version starts on your server's version, so you see mods made for it.
  4. Click Install on the mod you want, then Install again in the box that opens. It shows the version and the game version it's for. Any mods it needs are installed first.
  5. Repeat for any other mods, then restart your server (or start it if it's stopped).

Your server loads mods when it starts, so you don't need to stop it first. Changes take effect on the next restart.

Managing your mods

The Installed tab lists every mod on your server. For each one you can click Version to pick another version, Mod DB to open its page, or Uninstall. Click Check for updates to look for new versions.

The Updates tab shows mods with a newer version for your game version. Update them one at a time or click Update all. Untick In Update All on any mod you want it to skip. The HH Mod Manager icon shows a badge when updates are waiting.

The Needs attention tab shows mods your server might not load, and why: for example a mod made for an older game version, or one that needs another mod. Click Pick a version or Uninstall.

Tip: If a mod won't load, click Server log at the top. It shows the server's errors about each mod.

Method 2: The /moddb command

This works for mods listed in the Vintage Story Mod DB. Your server needs to be running.

  1. Open HH Server Admin and click Console on the left.
  2. Run this command, replacing ModID with the mod's identifier:
/moddb install ModID

The ModID is usually the last part of the mod's address. For https://mods.vintagestory.at/primitivesurvival, it's primitivesurvival.

  1. Restart the server for the mod to load.

Method 3: Upload the mod yourself

Use this for mods that aren't on the Mod DB, or that you downloaded as a .zip file.

  1. Connect to your server with the File Manager in the Game Control Panel or with FTP.
  2. Upload the .zip file to the Mods folder.
  3. Restart the server for the mod to load.

Troubleshooting

  • If a mod doesn't load, check it was made for your server's Vintage Story version. Mods for an older or newer version show under Needs attention.
  • To remove a mod, click Uninstall in the HH Mod Manager, or delete its .zip file from the Mods folder.