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

SMAPI 4.0.7 needs the latest Stardew Valley 1.6.4. If needed, you can reset your game files to force a game update check.

Recent patch releases:

  • 4.0.7 mainly updates for Stardew Valley 1.6.4, and improves installer feedback when invalid game folders are detected.
  • 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.

Requires Stardew Valley 1.6.4 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