How to Install Mods on Your Vintage Story Dedicated Server: A Step-by-Step Guide

Installing mods on your Vintage Story dedicated game server can enhance your gameplay experience. With just a few simple commands in the game panel Web Console, you can easily add mods to your server. Follow this guide to quickly and efficiently install your favorite mods.

Important Information Before Installation

• Compatibility Warning: Some mods may not be compatible or up-to-date with the current version of your server. If that's the case, you will typically receive a warning after the mod installation.

• Server Restart: Some mods require a server restart to take effect. Make sure to restart your server if necessary.

• Read Mod Descriptions: Always check the mod's description. Some mods may require additional configuration steps to work properly. These steps are usually listed on the mod's page.

• Install Mods Gradually: Avoid installing too many mods at once. Not all mods are well-maintained, and some may cause issues. It's recommended to install a few mods at a time, test them in-game, and then install more once you're sure everything is working smoothly.

How to Find the Mod Name You Need (Using the Website)

To install a mod, you first need to know its exact name. You can find mods on the official Vintage Story ModDB website. Here's an example using the Toolsmith mod, but the same steps apply to any mod.

Step-by-Step Guide:

1. Visit the Vintage Story ModDB page.

2. Find the mod you want to install (in this case, Toolsmith).

3. Open the mod's page and click the Files tab at the top.

4. Locate the version of the mod you want to install (the latest version is typically at the top).

5. Copy the mod's file name (e.g., toolsmith_1.0.12.zip). In this case, you only need to copy the name part: toolsmith.

How to Find the Mod Name You Need (Using the ModDB Search Function)

Sometimes, the ModDB website does not provide the correct ID needed to install a mod. For example, the mod Conquest Landform Overhaul may not show the right ID on the website. In such cases, you should use the in-game ModDB search command to find the correct ID.

Step-by-Step Guide

1. Start your Vintage Story server.

2. Open the Web Console.

3. Type the following command to search for the mod ID:

   /moddb search Landform

   (This will list all mods containing the keyword Landform.)

4. Locate the mod you need in the search results.

   • For example:
     Conquest Landform Overhaul: landformoverhaul

5. Install the mod using the ID you found in the previous step:

   /moddb install landformoverhaul

How to Install Mods Using the Web Console

1. Start your Vintage Story server.

2. Go to the Vintage Story ModDB website and find the mod you want to install.

3. Open the Web Console.

4. Type the following command to install the mod:
   /moddb install toolsmith
   (This command installs the Toolsmith mod in this example).

5. Join the server and test the mod to ensure it works as expected.

Visual Guide:

Check the video below for a visual step-by-step guide on how to install mods.

How to Install a Specific Version of a Mod

If you want to install a specific version of a mod, use the following command in the Web Console:
/moddb install <modname> <version>
For example, to install version 1.0.12 of the Toolsmith mod, you would type:
/moddb install toolsmith 1.0.12