Stardew Valley: SMAPI skipped your mods? Here's how to fix it
Updated 17 November 2026
Quick answerWhen SMAPI starts, it lists Skipped mods and gives a reason for each. Nearly always it's one of these: a framework mod is missing (like Content Patcher or SpaceCore), a mod needs a newer version of SMAPI or of another mod, or the mod wasn't unzipped properly. Each one is a quick fix.
The usual reasons, and the fix
| SMAPI says | What to do |
|---|---|
| "it requires mods which aren't installed" | Install the mod it names (often Content Patcher, SpaceCore or Json Assets), then restart. |
| "it needs newer versions of some mods" | Update the mod it names (usually a framework). |
| "it needs a newer version of SMAPI" | Download the latest SMAPI from smapi.io and run its installer again. |
| "its manifest is invalid" or "doesn't have a manifest.json" | The mod was unzipped wrongly or the download is broken. Download it again and unzip the whole folder into Mods. |
| "its DLL doesn't exist" | The mod's code file is missing. Download it again. |
After a Stardew Valley update
- Update SMAPI first. A new game version often needs a new SMAPI. Get it from smapi.io.
- Update your frameworks next. Content Patcher, SpaceCore, Generic Mod Config Menu and similar. Many other mods depend on them, so updating them fixes a lot at once.
- Start the game once and read SMAPI's window. Update or remove whatever it still lists as skipped or erroring.
- Then everything else. Mods made for Stardew 1.5 often broke in 1.6. Look for updated versions on their pages.
Each mod needs its own folder inside
Mods, with a manifest.json directly inside it. A folder whose name starts with a dot is switched off: SMAPI skips it on purpose.Where to find things
| What | Where |
|---|---|
| Mods folder | Your Stardew Valley game folder › Mods. On Steam: right-click the game › Manage › Browse local files. |
| SMAPI's log | Windows: Win + R, type %appdata%\StardewValley\ErrorLogs, open SMAPI-latest.txt. |
Questions
What's a "content pack"?
A mod that adds content (portraits, items, maps) but needs a framework mod to load it, usually Content Patcher. If the framework is missing, SMAPI skips the pack.
Do I need to reinstall SMAPI after every game update?
Only if the update needs a newer SMAPI. SMAPI's window tells you when a new version is available.
Can something check my Mods folder for me?
Yes. The free FixMyMods Stardew checker reads every mod's manifest.json, lists what's missing or out of date, and explains your SMAPI log in plain English.