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

For players, SMAPI 3.14.0 adds case-insensitive file paths on Linux, improved performance in some cases, and various other improvements and fixes.

For mod authors, this is a big update that adds content events, a redesigned content API, improved proxying, nullable reference type annotations, case-insensitive file paths in SMAPI APIs, and more. For C# mod authors, you should review the migration to SMAPI 4.0 guide to make sure your mods are ready for SMAPI 4.0.0 later this year. (You can update mods now, there's no need to wait for the 4.0.0 release.)

Patch release:

  • 3.14.1 improves performance for mods still using the old content API, temporarily disables case-insensitive paths pending a rework, and fixes various issues in 3.14.
  • 3.14.2 re-enables case-insensitive paths on Linux, improves performance, and fixes some mod assets not working correctly since 3.14.0.
  • 3.14.3 further improves performance, fixes an error with some mods using the old content API, and improves asset propagation for player sprites.
  • 3.14.4 improves performance for mods using deprecated APIs, and removes the warning for mods using dynamic (which now works fine on Linux/macOS).

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, DreamsInWiFi, elflion, Johnwawet, jwdred, Karmylla, Matthew Conklin, minervamaga, Rafael Miranda, Raimund58, Susan of the Drunk and Ugly Podcast, and a few anonymous users for their ongoing support on Patreon; you're awesome!

For mod creators