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 the main changes in 3.18.x.

This update lets you customize mod load order and disable console input, improves performance when applying mod content edits, fixes multiplayer map edits, fixes the SMAPI icon on Linux/macOS, 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.)

Recent patch updates:

  • 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.
  • 3.18.5 mainly overhauls compatibility rewriters to prepare for Stardew Valley 1.6 and simplify Android compatibility, improves startup times in some cases, fixes the SMAPI icon on Linux/macOS, and fixes various issues.
  • 3.18.6 mainly fixes SpriteMaster compatibility in 3.18.5+ with a temporary workaround, adds asset propagation for some chatbox textures, and fixes issues with the item console commands.

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