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

Patch releases:

  • 4.0.1 fixes an error in some cases when rewritten mod code removes items from an inventory.
  • 4.0.2 mainly tweaks errors to be clearer, fixes issues related to Extra Map Layers, and updates the compatibility list.
  • 4.0.3 updates for Stardew Valley 1.6.3, updates the mod compatibility list, and tweaks the player_add console command's errors for clarity.

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