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 saysWhat 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

  1. Update SMAPI first. A new game version often needs a new SMAPI. Get it from smapi.io.
  2. 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.
  3. Start the game once and read SMAPI's window. Update or remove whatever it still lists as skipped or erroring.
  4. 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

WhatWhere
Mods folderYour Stardew Valley game folder › Mods. On Steam: right-click the game › Manage › Browse local files.
SMAPI's logWindows: 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.

More guides

The Sims 4Sims 4 mods not working after an update: how to fix themWhy patches break mods, how to switch mods back on, and how to find the broken ones fast.MinecraftMinecraft mods crashing or won't load: how to find the causeWrong version, wrong loader or a missing mod: how to spot which, and read the crash report.GTA VGTA V mods not working after an update: how to fix them"Unknown game version", Script Hook V, the mods folder and Enhanced vs Legacy explained.