SMAPI is a free mod loader for Stardew Valley, intended to let players load and manage mods. It supports mod profiles, load-order control and dependency handling, and is compatible with GOG and Steam achievements. On Linux, macOS, Windows or Steam Deck, it requires Stardew Valley 1.6.14 or later. The maker also lists Android among its supported platforms. SMAPI 4.5 adds in-game configuration, performance improvements, automated and attested builds, and detection of malicious files. SMAPI.io provides modding documentation and source code for creators, along with a compatibility list, log parser, JSON validator and mod stats page. The parser can analyze and share uploaded logs and suggest fixes for common problems. The compatibility list is no longer comprehensively updated each month, and its future is in doubt. Update checks send game, SMAPI and mod versions plus platform type, but can be disabled. Submitted log and JSON files are retained in obfuscated form for 30 days. The maker says SMAPI can be uninstalled anytime.
Who it is for
SMAPI suits Stardew Valley players who want to load mods, and mod creators who need documentation or source code. It is intended for users with a compatible game installation.
What is good
- Supports mod profiles and load-order control.
- Handles mod dependencies.
- Compatible with GOG and Steam achievements.
- Log parser suggests fixes for common issues.
- Maker says it can be uninstalled anytime.
What to know first
- Requires Stardew Valley 1.6.14 or later on listed desktop platforms.
- Compatibility list is no longer comprehensively updated monthly.
- Submitted log and JSON files are stored for 30 days.
Freedom251 review
SMAPI: the full review
SMAPI provides mod-loading tools and creator resources for Stardew Valley, with a free plan. Note the game-version requirement and the compatibility list’s limited update status; update checks can be disabled.
SMAPI is a plugin loader for Stardew Valley, aimed at players who want to manage mods and creators who need modding resources. It is a focused choice for supported game versions, but its compatibility list is no longer comprehensively updated each month.
Overview
SMAPI loads Stardew Valley mods and supports load-order control, profiles, and dependency handling. Those controls help players organize a mod collection rather than merely add plugins. Its narrow scope is a benefit if Stardew Valley is the target, but it is not the choice for modding other games.
Version 4.5 adds in-game configuration and performance improvements, as well as automated and attested builds and malicious-file detection. The mix serves both routine configuration and build integrity, though none of it resolves the uncertainty around checking compatibility for individual mods.
Key features
- Mod management: Plugin loading, load-order control, profiles, and dependency handling give players several ways to organize a setup.
- Creator resources: SMAPI provides modding documentation and source code, making it relevant to people building Stardew Valley mods as well as players installing them.
- Web tools: SMAPI.io offers a log parser, JSON validator, mod stats page, and compatibility list. The parser analyzes and shares uploaded SMAPI logs and suggests fixes for common issues; the compatibility list is no longer comprehensively updated monthly, and its future is in doubt, so it should not be treated as a dependable current guide to every mod.
- Privacy and updates: SMAPI says it collects no telemetry or analytics and will not sell user information. Update checks transmit game, SMAPI, and mod versions along with platform type to its web API, but users can disable them. Log and JSON submissions to the parser or validator are retained for 30 days in obfuscated form in private Microsoft Azure Blob storage.
- Installation and help: Downloads are linked through GitHub, Nexus Mods, and CurseForge. SMAPI can be uninstalled at any time, and the maker directs users to Discord and Reddit for community support.
Pricing
SMAPI is free: the SMAPI plan costs 0.00 USD per free. There is no free trial because there is no paid tier to trial. The main condition is a compatible game installation: Stardew Valley 1.6.14 or later on Linux, macOS, Windows, or Steam Deck. Android is included among supported platforms, but the stated version requirement does not name Android.
Platforms
SMAPI supports Linux, macOS, Windows, Steam Deck, and Android. The game-version requirement explicitly covers Linux, macOS, Windows, and Steam Deck, so Android users should not assume the same requirement applies without checking their setup.
Who it's for
Choose SMAPI if you want to load and organize Stardew Valley mods, especially if profiles, dependencies, and load-order control matter to your setup. It also suits creators who want documentation and source code. It is a weaker fit for players who depend on a regularly maintained compatibility reference, or anyone seeking a loader for a different game.
Pros and cons
- Pro: Free access combines plugin loading with profiles, dependency handling, and load-order control.
- Pro: In-game configuration, performance improvements, and malicious-file detection are included in version 4.5.
- Pro: The log parser offers suggested fixes, while update checks can be disabled.
- Con: The compatibility list's monthly updates are no longer comprehensive, and its future is uncertain.
- Con: Update checks transmit version and platform data unless disabled; submitted logs and JSON files are retained for 30 days.
- Con: The explicit minimum game version does not cover Android, despite Android being a supported platform.
Alternatives
For loaders aimed at other games or broader platform combinations, consider Game Mod Loaders. The following options are also free, but serve different stated platform or game contexts:
- MelonLoader is another free option with Android, Linux, macOS, and Windows support.
- BepInEx supports Linux, macOS, and Windows, with manual installation and stable and bleeding-edge builds.
- ModTek is specifically a BattleTech PC game mod loader.
- MWSE supports Linux and Windows and welcomes contributions; its free software carries a GNU GPL license and absolutely no warranty.
- Satisfactory Mod Loader has no required dependencies and supports Windows client and server use, plus Linux server use.
- Hell2Modding supports macOS and Windows.
- Everest supports API, Linux, macOS, and Windows.
- Northstar supports Linux and Windows.
Verdict
SMAPI is the right pick for Stardew Valley players who want free plugin loading with practical controls for profiles, dependencies, and load order, and for creators who value its documentation and source code. Its focused toolkit is the main reason to choose it; look elsewhere if you need a reliably current compatibility list or are modding another game.
SMAPI plans and pricing
All plansCompared on game mod loaders
- Free plan
- Yes
- Supported games
- Stardew Valley
- Supported platforms
- Linux, macOS, Windows, Steam Deck, Android
- Mod loading method
- plugin
- Plugin support
- Yes
- Load-order control
- Yes
- Mod profiles
- Yes
- Dependency handling
- Yes
