What Is SMAPI and Why Does Every Stardew Mod Need It?
SMAPI — the Stardew Modding API — is the framework that makes practically every Stardew Valley mod possible. Created and maintained by Pathoschild, SMAPI sits between the game and your installed mods, handling loading, error logging, and compatibility checks [1]. Without it, you’re limited to clunky XNB file swaps that directly overwrite game assets — fragile, conflict-prone, and broken by every update. SMAPI mods, by contrast, interact with the game through a stable API, so dozens of mods can run simultaneously without stepping on each other.
SMAPI is free, open-source, and officially supported on Windows, Mac, Linux, and Steam Deck. The only safe place to download it is smapi.io — the official site maintained by Pathoschild. Don’t download SMAPI from any other source [1]. The current version, SMAPI 4.5.1, supports Stardew Valley 1.6.14 and above, and includes malicious file detection added in version 4.5.0.
One thing worth knowing upfront: ConcernedApe has been genuinely supportive of modding throughout the game’s decade-long lifespan. When Stardew Valley 1.6 launched, he released a list of over 1,000 verified compatible mods on launch day [5] — an extraordinary commitment from a solo developer. The SVE creator FlashShifter even had early access to the 1.6 codebase to ensure day-one mod compatibility [4]. The official relationship between modding and the base game is unusually close.
How to Install SMAPI: Step-by-Step
Installing SMAPI takes about five minutes on PC. Here’s the full process.
- Back up your save files before touching anything. On Windows, find them at %AppData%/StardewValley/Saves; on Linux/Mac at ~/.config/StardewValley/Saves.
- Download SMAPI from smapi.io — select the Windows, Mac, or Linux installer for your platform. Current version: SMAPI 4.5.1.
- Run the installer — double-click the downloaded file and follow the prompts. It auto-detects your Stardew Valley installation location.
- Launch via SMAPI — a new StardewModdingAPI executable appears in your game folder. Always use this to launch the game, not the original launcher. A SMAPI console window appears alongside the game — this is normal and expected.
- (Optional) Steam integration — the installer includes a Steam launch option setup that keeps Steam achievements working while running SMAPI.
Installing individual mods is equally simple:
- Download a mod as a .zip file from Nexus Mods or ModDrop.
- Extract the zip — each mod contains a folder with a manifest.json file inside.
- Copy that mod folder into the Mods directory inside your Stardew Valley installation folder.
- Restart via SMAPI. The console will flag any missing dependencies or compatibility warnings immediately.
That SMAPI console is your best debugging tool. If something goes wrong after adding a new mod, it will tell you exactly which mod is causing the problem and whether it needs updating.
Install These Framework Mods First
Before any content mods, you need four foundation mods that dozens of others depend on. Install these first — they’re infrastructure, not features, and have no visible in-game effect on their own.
- Content Patcher — Used by more than half of all SMAPI mods [3]. It lets content packs modify game assets with JSON configuration rather than directly overwriting core files. If any mod page says "requires Content Patcher", this is what it means. Supports SMAPI 4.4.0 and above.
- Generic Mod Config Menu (GMCM) — Adds an in-game settings panel so you can configure mods without hunting through JSON config files. Near-universal support among well-maintained mods.
- SpaceCore — Required by Stardew Valley Expanded and several other major content mods. Non-optional if you’re running SVE.
- Farm Type Manager — Generates custom forageables, monsters, and placement logic for modded farm maps. Also required by SVE and multiple expansion mods.
Best UI and Information Mods
These mods don’t add new content — they surface information that’s always been in the game but hidden in menus, or that previously required a constant browser tab to access.
Lookup Anything
Hover over anything in the game — a crop, NPC, fish, machine, item, or seed — and press F1 to see a live info panel with gift tastes, growth stages, machine processing times, spawn conditions, and more [3]. With over 183,000 endorsements on Nexus Mods, this is one of the most-endorsed mods on the entire platform. I’ve lost count of the number of times it’s saved me from opening a browser tab mid-session just to check whether a fish is currently in season or which museum artefact I’m still missing. If you install nothing else from this list, install this.
NPC Map Locations
Tracks every villager on your map in real time, with an optional minimap overlay. Essential once you’re actively working on friendship levels — particularly when timing a gift delivery around someone’s daily schedule. Pairs naturally with working through the Stardew Valley heart events guide for specific characters [1].
UI Info Suite 2
Adds persistent HUD elements showing crop growth days remaining, harvest-ready indicators, gift taste icons on NPC portraits, and a luck bar. Significantly reduces the back-and-forth between inventory, calendar, and the in-game interface that mid-game Stardew demands.
Experience Bars
Displays XP progress bars for all six skills on-screen rather than burying them in the inventory menu. A small change with a surprisingly motivating effect — you can see exactly how close you are to the next farming or fishing level without interrupting your day.
Data Layers
Adds colour-coded overlays showing sprinkler coverage, scarecrow radius, bee house range, and crop accessibility. Invaluable when optimising farm layout. Works especially well alongside Better Sprinklers (covered below) for planning coverage before you commit to placing anything.
Best Quality-of-Life Mods
Automate
Place a chest adjacent to any processing machine — keg, preserves jar, furnace, recycling machine, coop, barn — and Automate feeds inputs and collects outputs without any player action [3]. Chain machines to a shared chest and your entire processing line becomes hands-off. Created by Pathoschild (also SMAPI’s author), so compatibility is as guaranteed as it gets. This is the highest-impact single mod for late-game farm efficiency.
Tractor Mod
Buy a tractor from Robin’s shop and use it to water, fertilise, harvest, and clear debris across your farm in seconds [3]. The daily watering routine that consumes 20 minutes of every Summer morning becomes a 30-second pass. Energy saved on manual watering goes to mining or social activities instead — a significant compound benefit over a full playthrough.
CJB Cheats Menu
An in-game cheat console covering time control, item spawning, location warping, and weather freezing. If you’re testing mods on a fresh save, or want a relaxed creative-mode experience, this is the right tool. One honest caveat for new players: this removes most of the friction that makes early Stardew satisfying — better used in a second playthrough than your first.
Chests Anywhere
Access the contents of any chest on your farm from anywhere in the game. No more sprinting back to base to drop off your fishing haul before the day ends. Created by Pathoschild, works cleanly with multiplayer.
Convenient Inventory
Adds quick-stack to nearby chests, favourite item slots protected from accidental trashing, and an auto-organise button. The base game’s inventory management hasn’t aged well — this brings it up to modern standards without changing anything about the underlying gameplay.
Fast Animations
Removes padding frames from eating, fishing reel-in, and tool swing animations. Each cut is only a few frames, but across a long session the cumulative time saved is measurable. Near-zero conflict risk and no performance cost.
Best Visual and Aesthetic Mods
Seasonal Outfits
NPCs change their clothing to match the current season — scarves and coats in winter, light summer clothes in warmer months. This sounds minor, but Pelican Town feels genuinely more alive once residents stop wearing identical outfits year-round. One of those mods that becomes hard to play without after your first week using it.
Elle’s Animal Replacements
Replaces farm animal sprites with high-quality illustrated alternatives that include seasonal variation. The pigs and cows in particular are a significant upgrade over the base game equivalents, and the seasonal differences add a nice layer of visual continuity with the rest of the world.
Flower Valley
Adds floral decorations, planters, and seasonal flora across Pelican Town’s outdoor spaces. If you find the base game’s town sparse between festivals, this fills it out without altering NPC pathing or any gameplay systems.
Medieval Buildings
Replaces farm building sprites with stone-and-timber medieval architecture. Particularly effective on large established farms — when you have a silo, big barn, and full coop, having them look like an actual estate rather than a starter homestead changes the late-game feel considerably.
Best Content Expansion Mods
These are the big ones. If UI mods improve how the game communicates and QoL mods reduce friction, content expansions add entirely new games layered on top of the base Stardew experience. If you’re approaching them for the first time, starting a new save is strongly recommended for all of them.
Stardew Valley Expanded
SVE is the largest content mod for Stardew Valley — and quite possibly for any farming sim. Version 1.15.11, released June 2025, was developed in direct collaboration with ConcernedApe, who gave FlashShifter early access to the 1.6 codebase to ensure day-one compatibility [4]. The mod adds 28 new NPCs, 58 new locations, 278 character events, 43 fish species, a new farm map, and multiple new marriage candidates [3].
There’s a significant news angle here if you’ve been waiting to try SVE: FlashShifter has officially declared SVE 1.15 complete. No further content updates to SVE itself are planned — development has shifted to a new standalone mod called Castle Village. If you’ve been holding off until SVE finished, this is your window. SVE requires SpaceCore, Content Patcher, Farm Type Manager, and several smaller dependencies — use the requirements list on the Nexus Mods page for the current install order [3].
Ridgeside Village
The second-largest Stardew expansion adds an entirely new village accessible from the southwest of the base map — 50+ new NPCs, 22 marriage candidates, custom music, original festivals, and a multi-year questline [3]. Fully compatible with SVE; many players run both together for a near-total content overhaul. Expect longer load times with both installed, especially on older hardware. Version 2.5.21 or later is recommended.
East Scarp
A smaller, more focused expansion adding a new area east of the main valley with original NPCs and story events. Lighter on dependencies and system resources than SVE or Ridgeside — a solid middle ground if you want fresh narrative content without committing to the full SVE dependency stack.
Romanceable Rasmodius
Adds a full romance route for the Wizard, including new heart events, a custom gift system, and marriage dialogue. Long-standing fan favourite for players who always found the most mysterious NPC in Pelican Town frustratingly off-limits as a relationship candidate.
Best Farm Automation Mods
Better Sprinklers
Makes sprinkler range configurable per tier and allows custom coverage areas for Iridium Sprinklers. Pairs with Data Layers to plan coverage before committing, and with Automate for a near-fully autonomous farm once you reach mid-game.
Better Junimos
Expands Junimo hut behaviour with a configurable harvest radius, the ability to work during rain, smart crop detection, and timing controls. The base game’s Junimos are surprisingly limited — this addresses the most frustrating edge cases without changing core game balance.
Deluxe Auto-Grabber
Extends the auto-grabber to collect from coops, barns, and slime hutches automatically. Once you scale up your animal operation, removing the nightly collection loop from your routine is a meaningful quality-of-life win.
Skull Cavern Elevator
Adds checkpoint floors every five levels (configurable) to the Skull Cavern — equivalent to the base game’s mine elevator [3]. If you’ve ever reached floor 75 on a strong run only to get killed and restart from scratch, you understand exactly why this mod exists. It makes deep Skull Cavern runs a reliable endgame activity rather than a frustrating gamble. The floor interval is configurable — keep it at 10 or 20 if you want to preserve some of the tension.
Platform Availability: PC, Android, and Console
PC (Windows, Mac, Linux, Steam Deck)
Full SMAPI support on all desktop platforms. SMAPI 4.5.1 is current and supports SV 1.6.14+. Steam Deck users should select the Linux installer.
Android
SMAPI is available for Android but is officially classed as experimental [2]. It requires Stardew Valley 1.6.15+ from the Play Store or Galaxy Store. Installation involves sideloading the SMAPI Launcher APK from GitHub — more involved than the PC process, but well-documented on the Stardew Valley wiki [2]. The mod folder lives at /storage/emulated/0/StardewValley/Mods/.
Most framework mods and core QoL mods (Lookup Anything, Automate, NPC Map Locations, Content Patcher, GMCM) run well on Android. However, large content expansions — SVE and Ridgeside Village in particular — are known to cause performance problems and crashes on mobile hardware. Avoid them unless you have a recent high-end device and can confirm stability in a test save first.
iOS, Nintendo Switch, PlayStation, Xbox
No mod support on any of these platforms. This is a hard platform limitation — there is no workaround currently available.
Where to Download Mods Safely
There are two legitimate mod repositories:
- Nexus Mods (nexusmods.com/stardewvalley) — the primary community hub. Every mod has a version history, endorsement count, and comment section. Mods with 50,000+ downloads and an active update history are a reliable signal of quality and safety [3].
- ModDrop — a smaller but legitimate alternative. Well-moderated and regularly maintained.
Avoid random Discord links, Google Drive shares, and unofficial mod pack sites. Extracting an unknown .zip into your game directory carries real security risk. The absence of a Nexus Mods page is a red flag — even niche mods almost always have one. SMAPI 4.5.0+ includes some malicious file detection [1], but it’s not a substitute for basic download hygiene.
FAQ: Stardew Valley Mods
Can I use mods in multiplayer?
Yes, with caveats. The host’s mods generally govern the session. UI and cosmetic mods work independently for each player. Content expansion mods like SVE and Ridgeside Village should be installed by all players — running them only on the host’s machine causes sync issues and potential crashes.
Will 1.7 break my mods?
Probably some of them, yes. ConcernedApe has confirmed Stardew Valley 1.7 is in development — adding new marriage candidates and other content — but no release date has been given [6]. The Stardew Valley wiki has already published a 1.7 modding migration guide covering the changes [6]. SMAPI and Content Patcher handle most breaking changes automatically. XNB replacement mods (those that overwrite game files directly without SMAPI) will be most vulnerable. When 1.7 drops: let SMAPI update first, check smapi.io/mods for compatibility status, and hold off on your modded save for a day or two while the community confirms what works.
How many mods can I run at once?
There’s no hard cap, but more mods mean longer load times and more potential for conflicts. Most experienced players run 20-40 mods without issues. With SVE and Ridgeside Village both installed, expect load times of 3-5 minutes on older hardware — worth factoring in before committing to a full installation list.
Do I need a new save to use content expansion mods?
For SVE and Ridgeside Village, a new save is strongly recommended. Both mods add areas, story content, and character events from day one — joining on an existing save means missing the full early-game setup. You can add them mid-game, but you’ll get significantly less out of them.
Can I mod Stardew Valley on mobile?
On Android, yes — experimentally, via the SMAPI Launcher APK available on GitHub [2]. iOS has no mod support at all. See the Platform Availability section above for the full picture.
Final Thoughts
The Stardew Valley modding scene in 2026 is arguably at its most mature point. SVE is officially complete, SMAPI 4.5.1 is stable, and the 1.6 update gave the modding community a significantly more powerful toolset. Whether you install just Lookup Anything and Automate for a light enhancement, or commit to a full SVE plus Ridgeside playthrough with a fresh farm, everything on this list holds up against the current version of the game.
Start with the four framework mods, add Lookup Anything and NPC Map Locations as your information layer, then decide how deep you want to go. And when 1.7 eventually lands — wait for SMAPI to update, check the compatibility tracker, and give the community a day or two to flag what’s broken before relaunching your save.
For a full overview of the base game before you start modding, the complete Stardew Valley beginner’s guide covers everything you need to know about your first year on the farm.
Sources
- Pathoschild. SMAPI — Stardew Modding API. smapi.io.
- Stardew Valley Wiki. Modding: Installing SMAPI on Android. stardewvalleywiki.com.
- Nexus Mods. Stardew Valley mods repository. nexusmods.com/stardewvalley.
- GamesRadar. The creator of Stardew Valley’s best mod worked with ConcernedApe on update 1.6. gamesradar.com.
- PC Gamer. Stardew Valley creator releases a list of over 1,000 mods compatible with today’s 1.6 patch. pcgamer.com.
- Stardew Valley Wiki. Modding: Migrate to Stardew Valley 1.7. stardewvalleywiki.com.
I've been playing video games for over 20 years, spanning everything from early PC titles to modern open-world games. I started Switchblade Gaming to publish the kind of accurate, well-researched guides I always wanted to find — built on primary sources, tested in-game, and kept up to date after patches. I currently focus on Minecraft and Pokémon GO.