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.
What's new in SMAPI 3.0.1?
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 18.104.22.168.
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.
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.
New event system.
SMAPI 3.0 removes the deprecated static events in favor of the new
helper.EventsAPI. 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
assetsfolder by default if present, supports the new
.csprojproject format, enables mod
.pdbfiles 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.TargetPlatformso 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
DayTimeMoneyBoxbuttons. Every loaded texture now also has a
Namefield so mods can check which asset a texture was loaded for.
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.
Support SMAPI ♥
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!