How to Edit SMAPI Mod Config Files

Not only is SMAPI a fantastic program to easily add mods, but mods designed around SMAPI almost always contain editable configuration files that will let you even further customize most available mods! This requires an extremely small knowledge of basic programming, but we’ll teach you all you need to know right here!

Text Editor

Before we start, you’re going to need to download and install a text editor of your choice. Everything we will be editing in these .json files is very beginner-friendly and does not require much programming knowledge. Because of this, I recommend Notepad++ (click to download!) as it is very basic and allows us to do everything that we need. Feel free to use any other editor of your choice, though!

Editing Your Files

In order to make the .json files appear within your SMAPI Mods folder, you’ll need to make sure to run the game at least once after the mod has been added. Once done, open the specific mod’s folder that you’d like to edit and you should now see a config (it is usually named config, but if not, just look for the .json file!). Right click it and choose ‘Edit with Notepad++‘ or whichever text editor you chose to use.

From here a new window will appear with the options you are able to edit within the mod. For example, here’s the .json file for the Animal Friendship Labels Mod.

In this specific mod, I can change the text that is displayed on the tooltip by changing what is inside the quotes, like so:

Now instead of being displayed as “Is Loved” or “Needs Loved” it will be displayed as “Is Happy” or “Is Angry” in my game!

Almost all of the editing you’ll do in these files is as simple as this! However some mods may be slightly more complex, it all depends on what the author allows you to edit. Other common edits include changing keybinds or changing true and false statements. Check below for examples of each of these.

Editing Keybinds & True/False Statements

For these example we will be looking at a few lines from the config file of the Tractor Mod, check it out.

Let’s look at this line:

“TractorKey”: “B“,

This means the key to use the tractor is B. If we want to remap this to the F button, we can simply swap it to:

“TractorKey”: “F“,

Now for true and false statements, check out this line:

“AxeCutsFruitTrees”: false,

This means that while holding your axe on the tractor, you will not be able to cut fruit trees with it. If you want to be able to do this, change the statement to true, like so:

“AxeCutsFruitTrees”: true,

Always make sure to save and close your text editor and to relaunch your game once you’ve made your changes!


How to Mod Stardew Valley Using SMAPI

Itching to enhance your Stardew Valley gameplay with mods but don’t know where to begin? Look no further! It may seem like a daunting task at first, but it’s very simple with the use of a handy tool called
SMAPI created by Pathoschild.

Making a Backup

It’s always a good idea to make a backup of the vanilla version of the game in case you make any mistakes while installing mods. A simple way to do this is by right clicking Stardew Valley in your Steam Library, and then clicking Properties at the very bottom.

Once open, click the Local Files tab at the top, and then the Backup Game Files… option from this menu. Make sure Stardew Valley’s box is ticked when the list of your games appears, and click Next.

From here, simply click the Next button again and make your backup. Note that you can change the backup file’s save location to anywhere you’d like for easier access! Remember where this is in case you ever need a clean version of the game.

Installing SMAPI

Now that you’ve made your backup, you’ll need to follow the link above (or this one!) to download the latest version of the program. This will download a .zip file! We’ll need to open this with another program such as 7zip, WinRAR, or any unzipping program of your choosing. Once done, extract the files to a location of your choice and open the SMAPI folder you just extracted. Now you need to run the file named ‘install’ which will open up a black command prompt. Simply enter 1 and press enter from here to finish up!

If for some reason you receive an error using the ‘install’ file, you can also simply open the ‘interal‘ folder and copy and paste its contents to your Stardew Valley local files. These can be easily accessed by right clicking Stardew Valley in your Steam Library and choosing Properties (just like we did earlier!), going to the Local Files tab, and selecting Browse Local Files. Alternatively you can follow this path in your directory:

C: > Program Files (x86) > Steam > steamapps > common > Stardew Valley

Adding Your Mods

It’s time to add your mods! You’ll want to open your Stardew Valley local files again either by using the Steam Library or following the path mentioned above. If you’ve followed the steps correctly, you’ll now have a Mods folder. Simply download the mod you’d like to add (check out our mods page!), then drag and drop the mod’s folder into this folder. Now that everything is done, you will need to run the game with the StardewModdingAPI application file rather than your normal Stardew Valley application. This will firstly load your mods, and then load up the game for you as well. Read on to learn to do this automatically.

One Last Step

If you’re using Steam, you’ll want to enable SMAPI to work alongside it. To do this, you need to once again right click Stardew Valley in your Steam Library and select Properties. In the General tab, choose the Set Launch Options… button. In the box that appears, put a single quote () and then paste the path to your local files. It will look similar to this:

“C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley

Now add this (\StardewModdingAPI.exe” %command%) to the very end, for the final result of:

“C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe” %command%

Once you click OK your settings will be saved and SMAPI will now be configured to Steam and now automatically runs StardewModdingAPI when you click launch, and enables you to get achievements!

If you have a question or experience any issues, be sure to ask!
Happy Farming!