The mod loader for Stardew Valley. It works fine with GOG and Steam achievements, it's compatible with Linux/Mac/Windows, you can uninstall it anytime, and there's a friendly community if you need help. It's a cool pufferchick. Read more for installation instructions.
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
- Run the game without SMAPI at least once so it can do first-time setup.
- Download the latest version of SMAPI.
- Extract the .zip file somewhere (but not in your game folder!).
- Double-click install.exe¹, and follow the on-screen instructions.
The installer will detect your game and add SMAPI for you.
- 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.
- Open your game folder, select the full address, and press CTRL + C to copy it:
- In the Steam client, right-click on Stardew Valley and choose Properties:
- Click General > Set Launch Options:
- In the textbox...
- Type a single quote (").
- Press CTRL + V to paste the path you copied in step 1.
- Then type this after the path:
\StardewModdingAPI.exe" %command%
- It should look something like this (with your game path filled in):
- Click OK to save your changes.
- 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
- Run install.exe and choose uninstall.
- 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
- Install Mono.
- Download the latest version of SMAPI.
- Extract the .zip file somewhere (but not in your game folder!).
- Open a terminal in the extracted folder.
- 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
- Install Mono.
- Download the latest version of SMAPI.
- Extract the .zip file somewhere (but not in your game folder!).
- Run mono install.exe:
- Open the Terminal app.
- Type mono then a space.
- drag & drop the install.exe file onto the Terminal window to paste its file path.
- 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.