SMAPI 2.3 installer (Win/Mac/Lnx) file

What's new in SMAPI 2.3?

For players, this mainly adds a user-friendly download page and fixes a few issues.

For modders, this adds mod-provided APIs, which allow simple integrations between mods even without direct dependencies (see docs). 2.3 also reintroduces the

GameEvents.FirstUpdateTick event, adds an IsSuppressed flag to input events so mods can optionally avoid handling keys another mod has already handled, and fixes several issues.

Requires Stardew Valley 1.2.30+ on Linux/Mac/Windows. Compatible with most mods for SMAPI 0.40+.

See the release notes and mod compatibility list for more info.

The official website: Smapi.io

Installing SMAPI on Windows

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!).
4. Double-click install.exe¹, and follow the on-screen instructions.
   The installer will detect your game and add SMAPI for you.
5. If you use Steam, continue to the next section. 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. Open your game folder, select the full address, and press CTRL + C to copy it:
   
2. In the Steam client, right-click on Stardew Valley and choose Properties:
   
3. Click General > Set Launch Options:
   
4. In the textbox...
   1. Type a single quote (").
   2. Press CTRL + V to paste the path you copied in step 1.
   3. Then type this after the path:

      \StardewModdingAPI.exe" %command%

   4. It should look something like this (with your game path filled in):
      
5. Click OK to save your changes.
6. From now on, just launch the game through Steam to run SMAPI with the Steam overlay and achievements.

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

Update

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

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.)

Installing SMAPI on Linux

Install

1. Install Mono.
2. Download the latest version of SMAPI.
3. Extract the .zip file somewhere (but not in your game folder!).
4. Open a terminal in the extracted folder.
5. Run mono install.exe
   The installer will detect your game and add SMAPI for you.

That's it! Just launch the game to play with mods. You don't need to change your Steam launch options (that's only needed on Windows).

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

Update

Just install the new version; the installer will automatically clean up previous versions.

Uninstall

Run mono install.exe and choose uninstall.

Installing SMAPI on Mac

Install

1. Install Mono.
2. Download the latest version of SMAPI.
3. Extract the .zip file somewhere (but not in your game folder!).
4. Run mono install.exe:
   1. Open the Terminal app.
   2. Type mono then a space.
   3. drag & drop the install.exe file onto the Terminal window to paste its file path.
   4. Hit enter on your keyboard.

That's it! Just launch the game to play with mods. You don't need to change your Steam launch options (that's only needed on Windows).

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

Update

Just install the new version; the installer will automatically clean up previous versions.

Uninstall

Run mono install.exe and choose uninstall.