Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

SMAPI

smapi.io

  • Free plan
  • Windows
  • macOS
  • Linux
  • Android
7.6 Club score Visit smapi.io

What SMAPI is

SMAPI is a plugin-based mod loader for Stardew Valley, with tools for players and mod creators. It supports mod profiles, load-order control, and dependency handling, and works on Linux, macOS, Windows, Steam Deck, and Android. On Linux, macOS, Windows, or Steam Deck, it requires Stardew Valley 1.6.14 or later. The free plan is free, and SMAPI is compatible with GOG and Steam achievements. Version 4.5 adds in-game configuration, performance improvements, automated and attested builds, and detection of malicious files. SMAPI.io offers modding documentation and source code, plus a mod compatibility list, log parser, JSON validator, and mod stats page. The parser analyzes and shares uploaded SMAPI logs and suggests fixes for common issues. The compatibility list is no longer comprehensively updated each month, and its future is in doubt. Update checks share game, SMAPI, and mod versions along with platform type, but users can disable them. Parser and validator submissions are stored in obfuscated form for 30 days. The maker says SMAPI can be uninstalled anytime.

Who it suits

SMAPI suits Stardew Valley players who want to use and manage mods, including players on Android or desktop platforms. Its documentation and source code also serve mod creators.

Good to know, and what to watch

  • 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.
  • Requires Stardew Valley 1.6.14 or later on several platforms.
  • Compatibility list is no longer updated comprehensively each month.
  • Update checks send version and platform details unless disabled.
  • Submitted log and JSON files are stored for 30 days.

SMAPI

Free

Free plan

Getting started

  1. Open https://smapi.io/
  2. Download SMAPI through GitHub, Nexus Mods, or CurseForge
  3. Use it with Stardew Valley on a supported platform
  4. On Linux, macOS, Windows, or Steam Deck, ensure Stardew Valley is version 1.6.14 or later
  5. Configure profiles, dependencies, and load order for installed plugins

Limits to check

SMAPI requires Stardew Valley 1.6.14 or later on Linux, macOS, Windows, and Steam Deck. The compatibility list is no longer comprehensively updated each month, and files submitted to the parser or validator are stored in obfuscated form for 30 days.

The Club's review

SMAPI is a plugin loader for Stardew Valley, aimed at players who want to manage mods and creators who build them. It is a capable, free option if your game meets its version requirement, but its compatibility list is an uncertain guide to individual mods.

Overview

SMAPI is focused on one game: Stardew Valley. It combines plugin loading with load-order control, profiles, and dependency handling, giving players practical ways to organize a modded setup. That focus makes it a poor fit for anyone looking to mod other games.

SMAPI 4.5 adds in-game configuration and performance improvements, along with automated, attested builds and malicious file detection. Those features address both everyday mod management and build integrity. SMAPI can be uninstalled anytime, which lowers the commitment for players who want to try modding and remove it later.

Key features

  • Mod management: Plugin support, load-order control, profiles, and dependency handling help players keep a Stardew Valley setup organized.
  • Configuration and build safeguards: Version 4.5 brings configuration into the game and includes automated, attested builds and malicious-file detection. These are useful controls, though they do not establish whether each mod is compatible with a particular setup.
  • Troubleshooting: The SMAPI.io log parser analyzes uploaded logs, can share them, and suggests fixes for common issues. The JSON validator and mod stats page add supporting tools for creators and players.
  • Creator resources: Modding documentation and source code make SMAPI relevant to people developing mods, not only those installing them.
  • Downloads: The maker links to downloads from GitHub, Nexus Mods, and CurseForge.

The compatibility list is no longer comprehensively updated each month, and its future is in doubt. Treat it as a limited reference rather than a dependable way to verify a mod before installing it.

Pricing

SMAPI is free: its plan costs nothing. There are no paid tiers or trial to weigh against it. The trade-off is not a cheaper feature set; the key condition is that Stardew Valley must be version 1.6.14 or later on Linux, macOS, Windows, or Steam Deck.

Platforms

SMAPI supports Linux, macOS, Windows, Steam Deck, and Android. SMAPI is compatible with GOG and Steam achievements, a useful point for players who want mods without giving up those achievements.

SMAPI says it does not collect telemetry or analytics and will never sell user information. Update checks send game, SMAPI, and mod versions, plus platform type, to its web API; users can turn those checks off. Logs and JSON files submitted through the parser or validator are kept for 30 days in obfuscated form in private Microsoft Azure Blob storage.

Who it's for

SMAPI suits Stardew Valley players who want plugin-based mod management and troubleshooting tools, provided their game meets the stated requirement. It also serves mod creators through documentation, source code, and the JSON validator. Players who rely on a current compatibility catalogue to choose mods should be more cautious, and anyone modding a different game needs another tool.

For community help, the maker points users to Discord and Reddit.

Pros and cons

  • Pros:
    • Free access includes load-order control, profiles, and dependency handling, rather than plugin loading alone.
    • Log analysis with suggested fixes can help users diagnose common issues, and submitted logs can be shared.
    • Compatibility with GOG and Steam achievements matters to players who want to retain those achievements while modding.
    • Creators get documentation, source code, and a JSON validator alongside player-facing tools.
  • Cons:
    • The Stardew Valley version requirement excludes older game versions on the platforms named.
    • The compatibility list's update cadence is no longer comprehensive, and its future is uncertain, limiting its value when selecting individual mods.
    • Update checks transmit game, SMAPI, and mod versions plus platform type unless disabled; parser and validator submissions are retained for 30 days.
    • Its single-game focus makes it unsuitable for modding other titles.

Alternatives

For another game's loader, consider Satisfactory Mod Loader for Satisfactory: it is free on Linux and Windows, has no required dependencies, and supports Windows client and server as well as Linux server.

MWSE is another free option for Linux and Windows; its GNU GPL plan carries an absolute no-warranty disclaimer, and its project welcomes contributions such as bug fixes and documentation.

For Baldur's Gate 3, Baldur's Gate 3 Script Extender is free to obtain under its published license, though the Commons Clause restricts selling software whose value substantially derives from it.

MelonLoader is a free alternative for Android, Linux, macOS, and Windows under Apache License 2.0. BepInEx is free on Linux, macOS, and Windows, with manual installation and stable and bleeding-edge builds.

For other game-specific choices, Hollow Knight Modding API is free and has no paid tiers or usage limits stated; ModTek is a free BattleTech PC game mod loader; and RED4ext is a free Windows script extender and plugin manager for Cyberpunk 2077.

Browse the Game Mod Loaders directory for more options.

Verdict

Choose SMAPI if you want a free, focused way to manage Stardew Valley mods, with profiles, dependency handling, troubleshooting tools, and creator resources. Its main appeal is how much it brings together for one game; look elsewhere if your game is below version 1.6.14 on the named platforms, if you need a loader for another title, or if an actively maintained compatibility list is essential to your choices.

The verdict

SMAPI combines mod loading features with tools for troubleshooting and mod creation. Check the game-version requirement and the compatibility list's update limitations before relying on it.

Questions people ask

Is SMAPI free?

Yes. The SMAPI plan is listed as free, with no free trial because the software is free.

Which game does SMAPI support?

SMAPI supports Stardew Valley.

Which platforms can run SMAPI?

It supports Linux, macOS, Windows, Steam Deck, and Android.

What Stardew Valley version is required?

On Linux, macOS, Windows, or Steam Deck, SMAPI requires Stardew Valley 1.6.14 or later.

Does SMAPI collect telemetry?

The maker says SMAPI does not collect telemetry or analytics and will never sell user information. Update checks can be disabled.

Where can I get help or downloads?

Downloads are linked from GitHub, Nexus Mods, and CurseForge. Community help is available through Discord and Reddit.

What the maker publishes

Achievements
SMAPI is compatible with GOG and Steam achievements. source
Audience
SMAPI provides modding documentation and source code for mod creators. source
Compatibility list limitation
The mod compatibility list is no longer comprehensively updated each month, and its future is in doubt. source
Downloads
The maker links downloads from GitHub, Nexus Mods, and CurseForge. source
Features
SMAPI 4.5 adds in-game configuration, performance improvements, automated and attested builds, and malicious file detection. source
Log parser
The log parser can analyze and share uploaded SMAPI logs and displays suggested fixes for common issues. source
Privacy
SMAPI says it does not collect telemetry or analytics and will never sell user information. source
Purpose
SMAPI is the mod loader for Stardew Valley. source
Support
The maker points users to community help on Discord and Reddit. source
Tools
SMAPI.io provides a mod compatibility list, log parser, JSON validator, and mod stats page. source
Uninstall
The maker says SMAPI can be uninstalled anytime. source
Update checks
Update checks send game, SMAPI, and mod versions plus platform type to the web API; users can disable the checks. source
Uploaded files
Log and JSON files submitted through the parser or validator are stored for 30 days in obfuscated form in private Microsoft Azure Blob storage. source
Version requirement
SMAPI requires Stardew Valley 1.6.14 or later on Linux, macOS, Windows, or Steam Deck. source

Checked against the maker's pages on 29 Sept 2026.