3.6

This is an old release. You should use the latest version instead!

For players, SMAPI 3.6 mainly reduces startup time, improves crossplatform compatibility, simplifies some log messages, and improves the online JSON validator. For modders, it mainly adds event priorities and update subkeys, improves Harmony troubleshooting, and adds a Multiplayer.PeerConnected event. See the Reddit thread for release highlights.

Requires Stardew Valley 1.4.1 or later on Linux/Mac/Windows.

3.5

This is an old release. You should use the latest version instead!

SMAPI 3.5 mainly prevents more game errors for invalid item data (so you no longer need save editing to remove broken items), adds a new map patching API, adds patch helpers, improves SDate, and improves asset propagation. See the release highlights and Reddit thread.

Requires Stardew Valley 1.4.1 or later on Linux/Mac/Windows.

3.4.1

This is an old release. You should use the latest version instead!

SMAPI 3.4.1 fixes mouse input issues in SMAPI 3.4 for some mods, and adds NPC asset propagation in events for modders.

Requires Stardew Valley 1.4.1 or later on Linux/Mac/Windows.

3.4

This is an old release. You should use the latest version instead!

SMAPI 3.4 fixes transparency issues on MacOS, adds long-awaited support for map tile flip/rotation for modders, and includes some smaller fixes and improvements. See the release highlights and Reddit thread.

Requires Stardew Valley 1.4.1 or later on Linux/Mac/Windows.

3.3.2

This is an old release. You should use the latest version instead!

SMAPI 3.3.2 fixes mods receiving their own message broadcasts.

Requires Stardew Valley 1.4.1 or later on Linux/Mac/Windows.

3.3.1

This is an old release. You should use the latest version instead!

SMAPI 3.3.1 fixes an error with custom spouse room mods after 3.3.

Requires Stardew Valley 1.4.1 or later on Linux/Mac/Windows.

3.3

This is an old release. You should use the latest version instead!

SMAPI 3.3 mainly improves performance in some cases, fixes SMAPI update checks on Android, adds features for mod authors, and drops support for duplicate map tilesheets in Content. See also the release highlights and Reddit thread.

Requires Stardew Valley 1.4.1 or later on Linux/Mac/Windows.

3.2

This is an old release. You should use the latest version instead!

SMAPI 3.2 adds performance monitoring (disabled by default in this release), support for .tmx map files, persistent smapi-internal/config.json overrides, better Android compatibility, and various other improvements and fixes. See the release highlights and Reddit thread.

Requires Stardew Valley 1.4.1 or later on Linux/Mac/Windows.

3.1

This is an old release. You should use the latest version instead!

SMAPI 3.1 mainly improves performance and fixes bugs for players, adds a ChestInventoryChanged event and new asset propagation for modders, and includes various smaller improvements. See the release highlights.

Requires Stardew Valley 1.4.1 or later on Linux/Mac/Windows.

3.0.1

This is an old release. You should use the latest version instead!

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.