SMAPI

The mod loader for Stardew Valley.

Compatible with GOG/Steam achievements and Linux/macOS/Windows, uninstall anytime, and there's a friendly community if you need help.

Get help

(Or join the community!)

What's new

See the SMAPI 4.0 release highlights for the main changes.

SMAPI 4.0 mainly updates for Stardew Valley 1.6.0, improves performance and compatibility rewriting, adds per-mod-folder settings, and removes Error Handler (which is now integrated into the game itself). For mod authors, it mainly adds custom update manifests, adds new render step events, and drops deprecated APIs.

Recent patch releases:

  • 4.0.6 mainly lets mods set a min supported game version, to reduce issues from players who still have old game versions.
  • 4.0.5 mainly fixes mods sometimes not applying logic inside new buildings, and changes the installer to remove old SMAPI files and Error Handler.
  • 4.0.4 mainly adds a log_context console command and --prefer-terminal-name command-line argument, and fixes various issues.

Requires Stardew Valley 1.6.0 or later on Linux/macOS/Windows.

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

SMAPI is an open-source project by Pathoschild. It will always be free, but donations are much appreciated to help pay for development, server hosting, domain fees, coffee, etc.

Special thanks to Benjamin Schneider, Bpendragon, BrookIvy, elflion, Johnwawet, jwdred, Maria Stokes aka GamerGal2001, Karmylla, Matthew Conklin, minervamaga, Rafael Miranda, Raimund58, and a few anonymous users for their ongoing support on Patreon; you're awesome!

For mod creators