« back to index

Player's guide to using mods » use mods

Welcome to Stardew Valley modding! This guide will help you install mods and fix any problems that come up.
For players

If you’ve followed the guide so far, you already installed SMAPI. The hard part is done!

Download mods

There are two main places to download mods:

A few tips for downloading mods:

  1. Try one mod at a time. That way if the game crashes, you know which one is broken.
  2. Make sure the mod still works with the latest version of the game. Many mods are abandoned after their authors lose interest. There are a few ways to find out:
    • Does the mod description say which game versions it’s compatible with?
    • When you look at the latest comments for that mod, are several people saying it doesn’t work anymore? If so, it probably won’t work for you either.
    • Ask! The next player will thank you. If the author never responds, the mod is probably abandoned.

Install mods

To install a mod, just unzip it into the Mods folder inside your game folder. Make sure each mod has its own subdirectory; for example, if you have a PineapplesEverywhere mod, you should have a file structure like this:

<game folder>
   Mods/
      PineapplesEverywhere/
         PineapplesEverywhere.dll
         manifest.json

Uninstall mods

To uninstall a mod, just remove it from the Mods directory.

Configure mods

Some mods have a config.json file in their directory (see adding mods). It might be created the first time you launch the game with that mod. This file lets you customise the mod settings.

To edit the config.json file, just open it in a text editor. Make sure the game isn’t running when you edit it, or your changes might not take effect. See a basic guide to JSON; basically make sure your values are surrounded by quotes (like "value"). You can use this JSON validator to make sure the format is correct.

next: Troubleshooting & FAQs →