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.

Recent patch releases:

  • 4.0.8 mainly fixes crashes for some players, and drops support for Harmony 1.x to help reduce Harmony issues. (That should affect very few mods which still work today.)
  • 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.

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