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.

  1. 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.

  2. The mod is in the wrong place

    Each mod needs its own folder inside Mods, and that folder must contain a manifest.json file.

    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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

Ready to check your pack?

Most packs take a few seconds. Nothing is uploaded.

Open the checker