Guide · Stardew Valley · Game

Stardew Valley mods: SMAPI, safe downloads and how to install them

How to install SMAPI and Stardew Valley mods, where to download them, content packs versus SMAPI mods, game versions and multiplayer rules.

· tamaStardew Valley

Stardew Valley mods can do small things, like showing villagers on the map, or big ones, like Ridgeside Village, a new village on the west side of Stardew Valley. The official Stardew Valley Wiki defines a mod as “just a package of files which changes Stardew Valley in some way”. Most mods need one tool first: SMAPI, the mod loader. Install SMAPI, unzip mods into a folder, and play.

Nobody here has played a modded farm for this guide. Every step and version below comes from smapi.io, the official wiki’s modding pages and the mods’ own pages and repositories, checked on October 20, 2026. Mod details come from each author’s GitHub repository.

What SMAPI is

SMAPI calls itself “the mod loader for Stardew Valley”. It is an open-source project by Pathoschild, and it “is required for most types of Stardew Valley mods”. What it does for you, from the wiki’s player guide:

  • It loads mods into the game and gives them APIs to use.
  • It rewrites mods for cross-platform compatibility, “so you can use almost any mod on any platform”.
  • It catches errors. When a mod crashes, SMAPI shows the error in its console window and, in most cases, recovers the game.
  • It checks for updates and alerts you when a new mod version is out.
  • It detects incompatible mods and disables them “before it causes problems”.

On October 20, 2026 the current release is SMAPI 4.5.2, released March 14, 2026. It requires Stardew Valley 1.6.14 or later on Linux, macOS, Windows or Steam Deck. The 4.5 series added an in-game settings screen for SMAPI through Generic Mod Config Menu, builds that you can verify, and a check for “known malicious loose files in the Mods folder”.

SMAPI is “safely installed alongside your normal game, and you can uninstall it anytime”. Steam achievements keep working, provided you launch SMAPI through Steam.

Which platforms can use mods

The wiki’s support table:

Mod support by platform, from the Stardew Valley Wiki, October 20, 2026
Platform Mod support
Windows, macOS, Linux, Steam Deck Fully supported
Android Most mods supported
iOS No mod support
Nintendo Switch, PS4, PS Vita, Xbox One No mod support

Android uses a separate port of SMAPI, because “the Android version of the game is very custom compared to other platforms”. It is “still experimental”, requires Stardew Valley 1.6.15.1 or later from the Play Store or the Galaxy Store, and needs a 64-bit system. On Steam Deck, modding “may increase power usage”. The Steam Deck mods guide covers Desktop Mode, the Deck’s desktop, and Valve’s rules for software you add there.

How to install SMAPI on Windows

These steps come from the wiki’s Windows guide, with separate guides for macOS, Linux, Steam Deck and Android. On macOS, smapi.io asks you to follow the full guide “to avoid security warnings”.

  1. Run the game once without SMAPI, so it can do its first-time setup.
  2. Download the latest SMAPI from smapi.io. The site also links copies on Nexus, CurseForge and GitHub.
  3. Extract the .zip file. Your downloads folder is fine.
  4. Double-click install on Windows.bat and follow the instructions on screen.
  5. Set up your game client so it starts SMAPI, as below.

Steam

Keep the installer window open. It shows a line that ends in %command%. Copy the whole line, quotation marks included. In Steam, right-click Stardew Valley, choose Properties, and paste it into Launch Options. For most players it reads "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%. From then on, the normal Play button starts the game with mods, the Steam overlay and achievements.

GOG Galaxy and the Xbox app

For GOG Galaxy, save a small start.bat file in the game folder and set it as the default executable under Manage installation > Configure. The Xbox app takes a few more steps: install SMAPI into the game’s Content folder, then rename the game’s .exe and put a copy of StardewModdingAPI.exe in its place. Redo the last part after each game update.

If you do not care about achievements or play time, you can also start StardewModdingAPI.exe in the game folder directly. To update SMAPI, install the new version over the old one. To remove it, run the installer again and choose uninstall, then clear the launch option you set.

Where to download Stardew Valley mods

Where to look:

  • Nexus Mods. “Most mods are released here.” You need a free account, but “just don’t choose a package when you register.”
  • CurseForge and GitHub. SMAPI itself is offered on both, and many authors list their mods there too. The SMAPI compatibility data, for example, links Content Patcher on CurseForge as well as Nexus.
  • The official forums hold some mods, and the Chucklefish forums hold some older ones.
  • ModDrop. It “is currently not recommended due to lack of supervision on the part of the site owners”, and that “players should avoid it”.

Before you download, “check if it works with the latest version of the game”. This guide does not rank mods.

How to install Stardew Valley mods

With SMAPI in place, the whole install step is this: “To install a mod, just unzip it into the Mods folder in your game folder.” On Steam for Windows, the game folder is usually C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley. If you cannot find it, type show_game_files in the SMAPI console window.

Keep the folder clean:

  • Give each mod its own subfolder, without trailing numbers. A mod folder holds a manifest.json.
  • Unzip new downloads somewhere else first, then move the mod folder into Mods. This “helps prevent errors related to extra files”.
  • If a folder is named like PineapplesEverywhere-1234567890, look inside it for the real mod folder.
  • You can sort mods into subfolders such as Fruit mods. SMAPI searches inside each folder until it finds one.
  • To switch a folder off, put a dot in front of its name, like .disabled mods.

Some mods create a config.json the first time you start the game with them. Edit it in a text editor while the game is closed. To update a mod, the safest way is a clean update: delete the old folder and install the new version, which resets its settings. A merge update keeps your config.json: copy the new files over the old folder. To uninstall a mod, delete its folder and check its page for any extra steps.

Content packs and SMAPI mods

For a player, the difference is one extra download. The wiki’s modding index splits mods into two kinds. SMAPI mods, also called C# mods, are code and “can change fundamental game mechanics”. Content packs are “formatted text files that rely on a framework C# mod”. A content pack is “a collection of files loaded by a specific content pack framework (essentially a sub-mod)”, usually JSON files and images. Content packs “can make new NPCs, edit maps, add new items, add shops, and more”.

You install a content pack “just like a SMAPI mod”, and you also install the framework it needs. The most common framework is Content Patcher, which its README describes as a mod that “loads content packs to change the game’s data, images, and maps without replacing game files”. Content packs are often named after their framework: a folder named [CP] SampleName is a content pack for Content Patcher.

Stardew Valley Expanded shows both kinds in one mod. Its GitHub repository has a [CP] Stardew Valley Expanded content pack for Content Patcher, an [FTM] Stardew Valley Expanded pack for Farm Type Manager, and a separate code part that “adds coded elements to the game”. The content pack lists that code part as required.

XNB mods are an older kind. They replace files in the game’s Content folder, are “no longer recommended”, and were “mostly broken” by Stardew Valley 1.6. If a mod has .xnb files and no manifest.json, it is an XNB mod.

Game versions and broken mods after an update

The wiki’s version history, last edited May 9, 2026, lists Stardew Valley 1.6.15, released December 20, 2024, as the newest version. SMAPI 4.5.2 needs 1.6.14 or later, and the troubleshooting guide says to make sure you have 1.6.15 or later. To check your version, click the ? button on the title screen; the version shows in the bottom-left corner.

Big game updates break mods. Stardew Valley 1.6 was “a major update, so many mods will need to be updated for it”: “44% of SMAPI mods were ready on day one”. Most content packs work again once the SMAPI mod that loads them is updated. After a game update:

  1. Update SMAPI and all your mods to their latest versions. The top of the SMAPI log lists every mod with an update.
  2. Upload your log to the log parser at smapi.io/log. It can diagnose common errors.
  3. If one mod is still the problem, do a clean reinstall: remove all of its folders, download it again and follow the install steps on its page.

SMAPI also disables most incompatible SMAPI mods on its own. For XNB mods, “You’re on your own”. The SMAPI mod compatibility list used to be the place to check a mod after an update. Its page now says it “is no longer comprehensively updated each month, and its future is in doubt”, so treat it as a hint, not the final word. If you need time while mods catch up, Steam can roll the game back: open Properties > Betas and pick legacy_1.5.6. GOG Galaxy lists older versions under Extras.

Can mods break your save?

“Yes, but it’s extremely rare.” Only a few mods touch the save file at all, and you can usually stop using mods at any time. SMAPI makes a daily backup of your saves in Mods/SaveBackup, and your own backups are “strongly recommended even if you don’t use mods”.

Mods in multiplayer

Mods work in multiplayer, “but it depends on the mod”. Each player can usually have their own mods, and modded and unmodded players can play together. The wiki’s rules of thumb, for mods that do not say otherwise:

Who needs a mod in multiplayer, from the Stardew Valley Wiki, October 20, 2026
Type of mod Who it affects What the wiki says
Custom items Everyone All players should install it; players without it may see Error Items.
Custom locations Everyone All players should have the same location mods; entering a missing location can crash the game.
Custom NPCs Everyone All players should have the same NPC mods.
Time changes Everyone Only works when the main player installs it.
World changes Everyone Affects all players, no matter who installs it.
Custom UI Only you Only affects the players who installed it.
Map replacements Only you Only visible to players who install it.

Content Patcher’s README adds that it “works fine in multiplayer”, and that “It’s best if all players have the same content packs, but not required.” For anything else, check the mod’s page, often under a compatibility heading.

Well-known Stardew Valley mods

These six mods are all on the SMAPI compatibility list. Each is described in its own words.

Well-known mods, from their GitHub repositories, October 20, 2026
Mod Author Kind Its own description
Stardew Valley Expanded FlashShifter Content packs plus code An expansive fanmade mod for ConcernedApe’s Stardew Valley
Ridgeside Village Rafseazz Content packs plus code A small village located on the west side of Stardew Valley
Content Patcher Pathoschild Framework (SMAPI mod) Loads content packs which edit game data, images, and maps without changing the game files
Lookup Anything Pathoschild SMAPI mod See live info about whatever’s under your cursor
Automate Pathoschild SMAPI mod The machine will automatically pull raw items from the chest and push processed items into it
Chests Anywhere Pathoschild SMAPI mod Access your chests from anywhere and organize them your way

Stardew Valley Expanded

The manifest in SVE’s repository calls it “an expansive fanmade mod for ConcernedApe’s Stardew Valley” and lists version 1.15.11. As shown above, it needs Content Patcher and Farm Type Manager besides SMAPI, plus its own code part. Download it from the Nexus page that the repository links, and check that page for the current requirements.

Ridgeside Village

Ridgeside Village adds “a small village located on the west side of Stardew Valley”, reached by cable car from stairs north-east of the bus stop. Its README promises “new interesting people with immersive backstories, engaging dialogue and exciting events”. The installation guide in its repository lists Content Patcher, Custom Companions, Farm Type Manager and SpaceCore as required mods.

Content Patcher

Stardew Valley Expanded and Ridgeside Village both need it. Content Patcher 2.9.1 came out on March 14, 2026, for SMAPI 4.4.0 or later. Its README says it is “compatible with Stardew Valley 1.6+ on Linux/macOS/Windows, both single-player and multiplayer”. With Generic Mod Config Menu installed, it adds the settings of your content packs to that in-game menu.

Lookup Anything, Automate and Chests Anywhere

All three come from SMAPI’s author. Lookup Anything shows live information when you press F1: in its README’s words, “a villager’s favorite gifts, when a crop will be ready to harvest, how long a fence will last, why your farm animals are unhappy, and more”. Its newest version is 1.55.0, released March 14, 2026, and its manifest sets Stardew Valley 1.6.15 as the minimum game version. Automate lets you “connect multiple machines with a chest to create factories”. Chests Anywhere lets you reach your chests “from the comfort of your bed to the deepest mine level”.

Sources