Modding:Installing SMAPI on Windows

This page explains how to install SMAPI (the tool which lets you use mods) on Windows. See also:

• Instructions for Android
• Instructions for Linux
• Instructions for Mac

Install

Option A: use SMAPI's installer

See also unofficial video guide.

Part 1: install SMAPI

1. Run the game without SMAPI at least once (so it can do first-time setup).
2. Download the latest version of SMAPI.
3. Extract the .zip file somewhere (but not in your game folder! (nor the windows %TEMP% folder)).
4. Double-click install on Windows.bat¹, and follow the on-screen instructions.
   The installer will detect your game and add SMAPI for you.
   Note: if you get the error "Where is your game folder? Oops, couldn't find the game automatically. Type the file path to the game directory (the one containing 'Stardew Valley.exe'), then press enter.", you can go to this page to find your game folder.
5. If you use Steam, continue to the next section. If you use GOG Galaxy, skip to Part 3. Otherwise just run StardewModdingAPI.exe in your game folder to play with mods.

Part 2: configure Steam

You can use SMAPI through the Steam client to enable the overlay and achievements. This requires a few more steps.

1. Keep SMAPI's installer window open.
   (If you already closed it, just run it again. No need to uninstall first.)
2. Copy the text in the installer window that looks like this (see how to copy text):
   
   Make sure you copy the entire line, including both quotation marks " and the %command% part.
   Your final path should look something like this: "Your path here" %command%
3. In the Steam client, right-click on Stardew Valley and choose Properties:
   
4. Click General > Set Launch Options:
   
5. Replace anything in the textbox with the text you copied from the installer.
   To paste text, click in the box and press CTRL and V.
6. Click OK to save your changes.
7. From now on, just launch the game through Steam to run SMAPI with the Steam overlay and achievements.

Part 3: configure GOG Galaxy

You can use SMAPI through the GOG Galaxy client to enable the overlay and track play time. This allows you to launch Stardew Valley with the SMAPI console using GOG Galaxy.

1. Open Notepad and paste in the following: start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe" If Stardew Valley and SMAPI are not installed at C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\, (the default location for most people), replace that location with the location of where you installed Stardew Valley.
2. Click on File, then Save As...
   
3. Navigate to your Stardew Valley installation folder and change the file type from Text Documents to All Files as shown below and then click Save.
   
4. Then type start.bat for the file name as shown below
   
5. In the GOG Galaxy client, click on Stardew Valle' and then the settings icon on the right-hand side of the 'Play' button, then hover over 'Manage installation' and click 'Configure...' as shown below.
   
6. A new menu will appear. Check the "Custom executables / arguments" box.
   
7. Then click 'Add another executable / arguments'
   
8. Select start.bat in the window that appears and then click Open.
   
9. Finally, click the circle next to 'Default Executable' underneath File 2, then click OK.
   
10. From now on, you can launch Stardew Valley through GOG Galaxy and both the SMAPI console and game will load as expected!

¹ To install manually instead, see instructions in the installer's readme.

Option B: use ModDrop

ModDrop is a mod manager which supports SMAPI. It can install SMAPI, keep it updated, and simplify installing/updating mods.

1. Install ModDrop and open the client.
2. In the top-right corner, click Install SMAPI or Update Available.
3. A window should appear that says something like "A new version of SMAPI is available." Click the Install button and follow the on-screen instructions.

Option C: use Vortex

Vortex is a mod manager by Nexus Mods. It can install SMAPI, keep it updated, and simplify installing/updating mods.

Part 1: install SMAPI

1. Log into a Nexus Mods account.
2. Install and launch Vortex.
3. Click the Log In or Register button in the upper-middle part of the Vortex main screen. A web browser should open asking whether to authorize Vortex to sync with your Nexus Mods account. That enables the Mod Manager Download buttons on Nexus mod pages. Accept the authorization.
4. Set up Stardew Valley in Vortex by clicking the left-hand games tab, finding Stardew Valley, and clicking it. You may wish to set up the download folder locations as well in the left-hand Settings tab.
5. Click the notification bell in the upper-right hand corner, which will prompt you to download and install SMAPI.
6. After SMAPI is installed in Vortex, click enable and you're done!

Part 2: configure Steam or GOG Galaxy

See Part 2: configure Steam or Part 3: configure GOG Galaxy under Option A: use SMAPI's installer.

Update SMAPI

Option A: use SMAPI's installer

Just install the new version; the installer will automatically clean up previous versions. (You don't need to configure Steam again.)

Option B: use ModDrop

If you use the ModDrop mod manager:

1. Click Update Available in the top-right if it appears.
2. Follow the on-screen instructions.

Option C: use Vortex

If you use the Vortex mod manager:

1. Go to SMAPI's mod page and download it using the Mod Manager Download button.
2. Click Open Vortex when the popup appears.
3. Click the Vortex window, and the notification bell will appear with a notification in the upper right. Click install and then enable.

Uninstall

1. Run install.exe and choose uninstall.
2. Blank the Steam launch options (if you changed them).

(If you want to play without mods temporarily, you can just launch Stardew Valley.exe directly instead.)

← Getting Started