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:
| 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”.
- Run the game once without SMAPI, so it can do its first-time setup.
- Download the latest SMAPI from smapi.io. The site also links copies on Nexus, CurseForge and GitHub.
- Extract the
.zipfile. Your downloads folder is fine. - Double-click
install on Windows.batand follow the instructions on screen. - 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:
- Update SMAPI and all your mods to their latest versions. The top of the SMAPI log lists every mod with an update.
- Upload your log to the log parser at smapi.io/log. It can diagnose common errors.
- 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:
| 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.
| 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
- SMAPI
- SMAPI release notes
- SMAPI mod compatibility list
- SMAPI compatibility list data on GitHub
- Modding index (Stardew Valley Wiki)
- Player guide: getting started (Stardew Valley Wiki)
- Installing SMAPI on Windows (Stardew Valley Wiki)
- Installing SMAPI on Android (Stardew Valley Wiki)
- Installing SMAPI on Steam Deck (Stardew Valley Wiki)
- Player guide: troubleshooting (Stardew Valley Wiki)
- Content packs (Stardew Valley Wiki)
- Version history (Stardew Valley Wiki)
- Stardew Valley Expanded on GitHub
- Ridgeside Village on GitHub
- Pathoschild’s Stardew mods on GitHub
- Content Patcher README
- Content Patcher release notes
- Lookup Anything release notes