Jump to content
Stroam

How to install mods

Recommended Posts

Here's a guide on how to install mods. This guide assumes you know how to navigate web pages and browse through files on your computer. I'll specifically be covering windows as I assume anyone with linux can also figure it out with this information.

First, go to the mod release section of the forums.
image.png.97d94e82205e57532856e7e4a75ac6a8.png
 

Next, open the thread of the mod you want to download. I'll pick this one.

image.png.8fb62dba27cee093f069e44f08aaeb59.png

 

This mod like most will have a link for downloading the zip file. Some though will have a link to a github page where you can download the mod. Click on the zip file to start downloading it.

image.png.d33e2b301051c04838bd5cbcdee9dc1c.png

 

Once downloaded, it'll most likely be in your download folder. 

image.png.3d86ee6ef562fbd9986dcceaa2e978ed.png

 

You'll want to copy or cut the download and then navigate to the Mods folder where your Vintage Story files are. For windows they are in Username/AppData/Roaming/Vintagestory/Mods. There will be two mods in there as you can see from the picture. That's because the game modes are technically mods. Paste the zip file that you copied or cut, into this folder with the other mods.

image.png.282300c5143c0135cf0fc78c728a8788.png

If you are unable to locate your AppData folder it could be because it is hidden and you are not able to view hidden files and folders. To make it so you can, go to the top and click on View. From there navigate to where it says Hidden items and make sure it's check marked.

image.png.9f8b5ee8f7a2c8a7100ce1b801a255d3.png

 

From this point, you can probably start up Vintage Story and everything will work fine. The next section is common issues you may encounter.

 

 

Common issues:

The mod is not enabled. Start up the game and go to Mod Manager.
image.png.b950677beea2b3e7e547ccd7a53b7e7c.png

From there make sure the mode has a blue box in the top right. image.png.664e7953dda4dd4134ccf621f78d023b.png not enabled            image.png.55896ba4390d219f0f101db5fa580fcc.png enabled.

This is also where you get the mod version number. It's right next to the box and in this case, it's 1.0.0. The game version will be the version number on the Survival Mode mod.

 

 

Error

Vintage Story has a fairly fast update cycle and while it's not common for mods to break it can happen. When this happens you'll get an error. To locate the error you'll need to go to your log files which are in Username/AppData/Roaming/VintagestoryData/Logs.

image.png.20b83afe9b11370f62f749d0b36848eb.png

You'll want to then go to the mods page on the forums and post what you were doing prior to the error, the version of the mod, the game version you were using(instructions above), and the error file. Here are general guidelines for which file you need.

  • client-crash.txt - when the world crashes but the client doesn't and takes you back to the Vintage Story main page.
  • client-main.txt - when there's a graphical issue but the game doesn't crash.
  • server-main.txt - should probably always be included. Is when things don't work like they should. For instance, a recipe doesn't work.
  • VintagestoryCrash.txt - for when the Vintage Story crashes. The Vintage Story crash reported will pop up and ask you to report it on the issue tracker because it's most likely a vanilla bug brought to light by the mod. Please include all the information that you would for any error.

 

Edited by Stroam
  • Like 2
  • Thanks 1

Share this post


Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.


×
×
  • Create New...

Important Information

We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue.