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

This update lets you customize mod load order and disable console input, improves performance when applying mod content edits, fixes multiplayer map edits, prepares for the upcoming Stardew Valley 1.6, and raises all deprecation messages to the final level.

(Reminder for C# authors: make sure your mod code is ready for the upcoming SMAPI 4.0.0, which will release alongside Stardew Valley 1.6.)

Patch updates:

  • 3.18.1 fixes mod texture edits sometimes cut off.
  • 3.18.2 fixes empty save backups on macOS, fixes player_add command's handling of custom slingshots, adds DelegatingModHooks for mod authors, and updates dependencies.
  • 3.18.3 mainly fixes bugs and errors, updates Korean translations, removes the LargeAddressAware flag, and adds PerScreen.IsActiveForScreen for mod authors.
  • 3.18.4 mainly shows whether you're the host or a farmhand in the window titles in multiplayer, improves the test_input console command, improves support for automated installs, updates dependencies, and fixes bugs and errors.

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