Troubleshooting

Fix Content Patcher problems step by step.

Content Patcher not working? Start here

Most problems come down to a handful of causes. Go through this checklist first:

  • You start the game through SMAPI and a console window opens next to the game.
  • SMAPI matches your game version. Stardew Valley 1.6 needs SMAPI 4.0 or later.
  • The path is Mods/ContentPatcher/manifest.json, not a folder inside another folder.
  • Each content pack is its own folder next to ContentPatcher, with its own manifest.json.
  • Content Patcher is up to date (see the Download page).
  • Every requirement listed by a pack is installed.

Read the SMAPI console and log

SMAPI reports every problem in its console: red lines are errors, yellow lines are warnings. At startup it also lists skipped mods with the reason each one couldn’t load, such as a missing requirement or an outdated version.

The same text is saved in a log file, SMAPI-latest.txt:

Windows
%appdata%\StardewValley\ErrorLogs
macOS / Linux
~/.config/StardewValley/ErrorLogs

Content Patcher adds console commands too. Type patch summary in the SMAPI console to see every loaded patch, whether it is applied and, if not, why.

“Content Patcher can’t apply image patch”

This error means an EditImage patch doesn’t fit the image it targets. Check these causes in order:

  1. Missing or misspelled file. The FromFile path must match the real file name. macOS and Linux are case-sensitive, so Abigail.png and abigail.png are different files.
  2. Image too large for the area. The pasted image (or its FromArea) must fit inside the target image at the ToArea position.
  3. Pack made for an older game version. Some images changed size or moved in Stardew Valley 1.6. Update the content pack.
  4. Not a valid PNG. Re-export the image as a standard PNG file.

Content Patcher not downloading

  • Check your browser’s Downloads list: the file may have finished quietly or be waiting for permission.
  • Some browsers or antivirus tools pause archive downloads. Allow the file, or try another browser.
  • The download is a .zip archive. Unzip it first (Windows Explorer and macOS can do this without extra software), then move the ContentPatcher folder into Mods. Don’t put the .zip file itself into Mods.
  • If the button on the Download page doesn’t respond at all, please contact Support.

Mods in the wrong folder

  • Double folder: unzipping can create Mods/ContentPatcher/ContentPatcher/. Move the inner folder up one level.
  • Wrong game copy: if you have more than one installation, make sure SMAPI and your mods are in the copy you actually launch.
  • Inside the Content folder: content packs belong in Mods, never in the game’s Content folder.

Outdated versions

After a big game update, older mods may stop working until they are updated. Update in this order: SMAPI, then Content Patcher, then your content packs. If SMAPI says a pack needs a newer version of Content Patcher (or uses a newer Format), update Content Patcher. If a pack hasn’t been updated for 1.6, look for a newer version of that pack or remove it for now.

Conflicts with other mods

  • Two packs load the same asset: only one Load per asset is allowed, so SMAPI reports an error and skips one. Keep the pack you prefer.
  • Two packs edit the same image: both apply, and the one applied last is drawn on top. If the result looks wrong, remove one of them.
  • Finding the culprit: move half of your content packs out of Mods, test, and repeat with the half that has the problem until one pack is left.

Alternative Textures vs Content Patcher

Players often ask whether to use Content Patcher or Alternative Textures. They are different tools that work well together:

Content Patcher
Changes the game’s assets themselves: images, data, maps and dialogue. A change applies everywhere, for example to every chicken or every copy of a building, and can depend on conditions like season or weather.
Alternative Textures
Adds texture variants that you pick for individual objects, furniture, buildings or crops in your world, one at a time.

Each framework only loads packs made for it, so check which one a pack requires before you install it.

Still stuck?

Read the FAQ, follow the installation guide step by step, or contact Support with your SMAPI log attached.