SMAPI

See the SMAPI website for recommended download sources.

See the SMAPI 4.0 release highlights for the main changes.

SMAPI 4.0 mainly updates for Stardew Valley 1.6, improves performance and compatibility rewriting, adds per-mod-folder settings, and removes Error Handler (which is now integrated into the game itself). For mod authors, it mainly adds custom update manifests, adds new render step events, and drops deprecated APIs.

Recent patch releases:

• 4.0.8 mainly fixes crashes for some players, and drops support for Harmony 1.x to help reduce Harmony issues. (That should affect very few mods which still work today.)
• 4.0.7 mainly updates for Stardew Valley 1.6.4, and improves installer feedback when invalid game folders are detected.
• 4.0.6 mainly lets mods set a min supported game version, to reduce issues from players who still have old game versions.

Requires Stardew Valley 1.6.4 or later on Linux/macOS/Windows.

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

SMAPI 4.0.7 mainly updates for Stardew Valley 1.6.4, and improves installer feedback when invalid game folders are detected.

Requires Stardew Valley 1.6.4 or later on Linux/macOS/Windows.

See the SMAPI website for recommended download sources.

See the SMAPI 4.0 release highlights for the main changes.

SMAPI 4.0 mainly updates for Stardew Valley 1.6.0, improves performance and compatibility rewriting, adds per-mod-folder settings, and removes Error Handler (which is now integrated into the game itself). For mod authors, it mainly adds custom update manifests, adds new render step events, and drops deprecated APIs.

Recent patch releases:

• 4.0.6 mainly lets mods set a min supported game version, to reduce issues from players who still have old game versions.
• 4.0.5 mainly fixes mods sometimes not applying logic inside new buildings, and changes the installer to remove old SMAPI files and Error Handler.
• 4.0.4 mainly adds a log_context console command and --prefer-terminal-name command-line argument, and fixes various issues.

Requires Stardew Valley 1.6.0 or later on Linux/macOS/Windows.

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

SMAPI 4.0.5 mainly fixes mods sometimes not applying logic inside new buildings, and changes the installer to remove old SMAPI files and Error Handler.

Requires Stardew Valley 1.6.0 or later on Linux/macOS/Windows.

See the SMAPI website for recommended download sources.

See the SMAPI 4.0 release highlights for the main changes.

SMAPI 4.0 mainly updates for Stardew Valley 1.6.0, improves performance and compatibility rewriting, adds per-mod-folder settings, and removes Error Handler (which is now integrated into the game itself). For mod authors, it mainly adds custom update manifests, adds new render step events, and drops deprecated APIs.

Patch releases:

• 4.0.1 fixes an error in some cases when rewritten mod code removes items from an inventory.
• 4.0.2 mainly tweaks errors to be clearer, fixes issues related to Extra Map Layers, and updates the compatibility list.
• 4.0.3 updates for Stardew Valley 1.6.3, updates the mod compatibility list, and tweaks the player_add console command's errors for clarity.
• 4.0.4 mainly adds a log_context console command and --prefer-terminal-name command-line argument, and fixes various issues.

Requires Stardew Valley 1.6.0 or later on Linux/macOS/Windows.

See the SMAPI website for recommended download sources.

See the SMAPI 4.0 release highlights for the main changes.

SMAPI 4.0.0 mainly updates for Stardew Valley 1.6.0, improves performance and compatibility rewriting, adds per-mod-folder settings, and removes Error Handler (which is now integrated into the game itself). For mod authors, it mainly adds custom update manifests, adds new render step events, and drops deprecated APIs.

Patch releases:

• 4.0.1 fixes an error in some cases when rewritten mod code removes items from an inventory.
• 4.0.2 mainly tweaks errors to be clearer, fixes issues related to Extra Map Layers, and updates the compatibility list.
• 4.0.3 updates for Stardew Valley 1.6.3, updates the mod compatibility list, and tweaks the player_add console command's errors for clarity.

Requires Stardew Valley 1.6.0 or later on Linux/macOS/Windows.

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

SMAPI 4.0.2 mainly tweaks errors to be clearer, fixes issues related to Extra Map Layers, and updates the compatibility list.

Requires Stardew Valley 1.6.0 or later on Linux/macOS/Windows.

See the SMAPI website for recommended download sources.

See the SMAPI 4.0 release highlights for the main changes.

SMAPI 4.0.0 mainly updates for Stardew Valley 1.6.0, improves performance and compatibility rewriting, adds per-mod-folder settings, and removes Error Handler (which is now integrated into the game itself). For mod authors, it mainly adds custom update manifests, adds new render step events, and drops deprecated APIs.

Patch releases:

• 4.0.1 fixes an error in some cases when rewritten mod code removes items from an inventory.

Requires Stardew Valley 1.6.0 or later on Linux/macOS/Windows.

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

See the SMAPI 4.0 release highlights for the main changes.

SMAPI 4.0.0 mainly updates for Stardew Valley 1.6.0, improves performance and compatibility rewriting, adds per-mod-folder settings, and removes Error Handler (which is now integrated into the game itself). For mod authors, it mainly adds custom update manifests, adds new render step events, and drops deprecated APIs.

Requires Stardew Valley 1.6.0 or later on Linux/macOS/Windows.

⚠️ Click here to download SMAPI!

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.

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

SMAPI 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.

Requires Stardew Valley 1.5.6 or later on Linux/macOS/Windows.

⚠️ Click here to download SMAPI!

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.

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

SMAPI 3.18.3 mainly fixes bugs and errors, updates Korean translations, removes the LargeAddressAware flag, and adds PerScreen.IsActiveForScreen for mod authors.

Requires Stardew Valley 1.5.6 or later on Linux/macOS/Windows.

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

SMAPI 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.

Requires Stardew Valley 1.5.6 or later on Linux/macOS/Windows.

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

SMAPI 3.18.1 fixes mod texture edits sometimes cut off.

Requires Stardew Valley 1.5.6 or later on Linux/macOS/Windows.

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

See the SMAPI 3.18 release highlights for details.

This 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.

Requires Stardew Valley 1.5.6 or later on Linux/macOS/Windows.

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

SMAPI 3.17.2 fixes an installer error when Steam's .vdf library uses an older format, and fixes an image patch offset issue.

Requires Stardew Valley 1.5.6 or later on Linux/macOS/Windows.

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

SMAPI 3.17.1 fixes an installer error when Steam's .vdf library data is missing.

Requires Stardew Valley 1.5.6 or later on Linux/macOS/Windows.

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

See the SMAPI 3.17 release highlights for details.

For players: this mainly optimizes performance, adds a separate 'strict mode', and drops the transitional 'raw image loading' option (now always enabled, except when PyTK is installed).

For mod authors: this mainly makes consumer info available when implementing GetApi in a C# mod, updates the mod build package, and words deprecation messages more strongly.

Requires Stardew Valley 1.5.6 or later on Linux/macOS/Windows.

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

SMAPI 3.16.2 fixes a NoSuitableGraphicsDeviceException launch error for some players with compatible GPUs since 3.16.0.

Requires Stardew Valley 1.5.6 or later on Linux/macOS/Windows.