Modding:Player Guide/Getting Started
Now that you know the basics of moddings, here's how to get started!
First you'll need to install the mod loader, SMAPI. Click the right link for more info:
Next you can download the mods you want. Some suggestions:
- most popular mods on Nexus;
- recommendations for a first playthrough;
- search for mods here:
site description Nexus Mods Most mods are released here.
(Registering an account is free, just don't choose a package when you register.)
Chucklefish mods Some mods are released here (most are also on Nexus). ModDrop Pretty new. Not many mods yet, but you can install those it has very quickly through their (Windows-only) client. Stardew Valley forums Some mods are posted directly in the forums. Some hidden gems are only here, but finding them can be a challenge.
Before you download a mod...
- Does it work with the latest version of the game? (SMAPI will automatically disable most incompatible SMAPI mods, but you're on your own with XNB mods. Try checking the mod description or comments.)
- Don't download from stardewvalleymods.net. (Mods here are usually outdated, since the site republishes mods without permission for ad revenue.)
Find your game folder
Next you'll need to open your game folder (the one containing Stardew Valley's
.exe file). Here's where to find it:
|Windows|| GOG: |
|Linux|| GOG: |
|Mac|| GOG: |
On Mac, the
Not there? Here are some other ways to find it:
To install a mod, just unzip it into the
Mods folder in your game folder. Make sure each mod has its own subfolder. For example, if you have a
PineapplesEverywhere mod, you should have a file structure like this:
Stardew Valley/ Mods/ PineapplesEverywhere/ PineapplesEverywhere.dll manifest.json
Some mods have a
config.json file in their mod folder. 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.
- To update a mod, download the latest version and copy the new files into the existing folder. That should replace the older files, but keep any config or data files it generated for you.
- To remove a mod, just remove it from the
XNB mods replace files in your game's
Content folder with custom versions. If a mod has some
.xnb files and no
manifest.json, it's an XNB mod. This is an older type of mod that's no longer recommended, but see Modding:Using XNB mods if you're still interested.