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

For players: this adds better DPI awareness, better macOS terminal support, an error message when you have loose mod files in Mods, and exit codes (which tell your OS whether the game quit normally or crashed).

For mod authors: this adds support for implicit assembly dependencies and F#, migrates to the crossplatform .pdb format, and raises deprecation levels. (Reminder for C# authors: make sure your mod code is ready for SMAPI 4.0.0, releasing later this year!)

Patch updates:

  • 3.16.1 updates PyTK compatibility mode for the latest PyTK version, and fixes broken mods sometimes incorrectly listed as duplicate.
  • 3.16.2 fixes a NoSuitableGraphicsDeviceException launch error for some players with compatible GPUs since 3.16.0.

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