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 3.17 release highlights for details.

For players: this mainly optimizes performance, adds a separate 'strict mode', and drops the transitional 'raw image loading' option (now always enabled, except when PyTK is installed).

For mod authors: this mainly makes consumer info available when implementing GetApi in a C# mod, updates the mod build package, and words deprecation messages more strongly. (Reminder for C# authors: make sure your mod code is ready for SMAPI 4.0.0, releasing later this year!)

Patch updates:

  • 3.17.1 fixes an installer error when Steam's .vdf library data is missing.
  • 3.17.2 fixes an installer error when Steam's .vdf library uses an older format, and fixes an image patch offset issue.

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