Mods not loading? Check these 6 things
Most of the time, Stardew mods do not load for one of six reasons: the game was not started through SMAPI, the mod is in the wrong folder, a required mod is missing, the mod is too old, two copies of the same mod are installed, or SMAPI itself is out of date. Paste your SMAPI log into the checker to see which one it is.
The game is not starting through SMAPI
Mods only load when you start the game with SMAPI. If you do not see a black SMAPI console window, mods are not running.
How to fix: On Steam (Windows), right-click Stardew Valley → Properties → Launch Options, and set it to
"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%(change the path if your game is somewhere else). Then start the game from Steam as usual.The mod is in the wrong place
Each mod needs its own folder inside
Mods, and that folder must contain amanifest.jsonfile.How to fix: Unzip the download. Do not leave a .zip file in the Mods folder. Open the mod folder: if you only see another folder, move that inner folder into Mods instead.
A required mod is missing
Many mods need a framework such as Content Patcher or SpaceCore. Without it, SMAPI skips the mod and says it "requires mods which aren't installed".
How to fix: Install every mod listed under Requirements on the mod page. The checker names the missing mod and links to a search for it.
The mod is too old for your game
Stardew Valley 1.6 broke many older mods. SMAPI marks them as "no longer compatible" or "broken".
How to fix: Check the mod page for a newer version. If there is none, remove the mod — or look for an unofficial update on smapi.io/mods.
The same mod is installed twice
Two folders with the same mod ID means SMAPI can only load one of them. This often happens after updating a mod without deleting the old folder.
How to fix: Keep the newest folder and delete the other one.
SMAPI is out of date
New mods often need a newer SMAPI. The log will say a mod needs a newer version of SMAPI.
How to fix: Download the latest SMAPI from smapi.io and run the installer again. Your mods are kept.