SMAPI

The mod loader for Stardew Valley. It works fine with GOG and Steam achievements, it's compatible with Linux/Mac/Windows, you can uninstall it anytime, and there's a friendly community if you need help. It's a cool pufferchick.

Get help

What's new in SMAPI 3.0.1?

GitHub release:

SMAPI 3.0 is a major update that adds compatibility with Stardew Valley 1.4, and includes many improvements for both players and modders.

SMAPI 3.0.1 mainly fixes compatibility with Stardew Valley 1.4.0.1.

For players:

  • Updated for Stardew Valley 1.4.
    SMAPI 3.0 adds compatibility with the latest game version, and improves mod APIs for changes in the game code.

  • Improved performance.
    SMAPI should have less impact on game performance and startup time for some players.

  • Automatic save fixing and more error recovery.
    SMAPI now detects and prevents more crashes due to game/mod bugs, and automatically fixes your save if you remove some custom-content mods.

  • Improved mod scanning.
    SMAPI now supports some non-standard mod structures automatically, improves compatibility with the Vortex mod manager, and improves various error/skip messages related to mod loading.

  • Overhauled update checks.
    SMAPI update checks are now handled entirely on the web server and support community-defined version mappings. In particular, false update alerts due to author mistakes can now be solved by the community for all players.

  • Fixed many bugs and edge cases.

For modders:

  • New event system.
    SMAPI 3.0 removes the deprecated static events in favor of the new helper.Events API. The event engine is rewritten to make events more efficient, add events that weren't possible before, make existing events more useful, and make event usage and behavior more consistent. When a mod makes changes in an event handler, those changes are now also reflected in the next event raise.

  • Improved mod build package.
    The mod build package now includes the assets folder by default if present, supports the new .csproj project format, enables mod .pdb files automatically (to provide line numbers in error messages), adds optional Harmony support, and fixes some bugs and edge cases. This also adds compatibility with SMAPI 3.0 and Stardew Valley 1.4, and drops support for older versions.

  • Mods loaded earlier.
    SMAPI now loads mods much earlier, before the game is initialised. That lets mods do things that were difficult before, like intercepting some core assets.

  • Improved Android support.
    SMAPI now automatically detects when it's running on Android, and updates Constants.TargetPlatform so mods can adjust their logic if needed. The Save Backup mod is also now Android-compatible.

  • Improved asset propagation.
    SMAPI now automatically propagates asset changes for farm animal data, NPC default location data, critter textures, and DayTimeMoneyBox buttons. Every loaded texture now also has a Name field so mods can check which asset a texture was loaded for.

  • Breaking changes:
    See migrate to SMAPI 3.0 and migrate to Stardew Valley 1.4 for more info. If you need help, feel free to ask! Also consider going open-source if you haven't already; we often submit pull requests to help update open-source mods.

Requires Stardew Valley 1.4 or later on Linux/Mac/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 bwdy, hawkfalcon, iKeychain, jwdred, Karmylla, minervamaga, Pucklynn, Renorien, Robby LaFarge, Susan of the Drunk and Ugly Podcast, and a few anonymous users for their ongoing support on Patreon; you're awesome!

For mod creators