« back to index

Player's guide to using mods » troubleshooting & FAQs

Welcome to Stardew Valley modding! This guide will help you install mods and fix any problems that come up.
For players

Intro

Use or create mods

See the intro pages for using mods, or creating a SMAPI mod for creating mods.

Find help

For help with a mod, the mod author is the best person to ask. These are the best ways to contact them:

  1. the discussion thread linked to on the mod page (if any);
  2. the ‘bugs’ section on the Nexus mod page (if any);
  3. otherwise contact the author directly (e.g. use the ‘Contact’ button on the Nexus mod page).

For help with SMAPI, or if you can’t ask the mod author, post in this thread or ask in Discord.

What to include in a bug report

Figuring out why something went wrong for someone else can be tough, so it helps if you include as much information as possible. Here’s the most useful information you can give.

  1. Describe your problem:
    • Which mod has an issue?
    • What is the problem? Be as descriptive as possible. (Does the game freeze or close? Does the screen go black? Does nothing at all happen?)
    • What were you doing when it broke? Did you notice a pattern? For example, maybe it always breaks when you do a certain thing.
  2. Describe your context:

    • Do you use a mod manager? If so, which one?
    • Do you play on Linux, Mac, or Windows?
  3. Cause the problem again (so any details are in the log), then attach a copy of the latest log file.
    (See Where is my error log and how can I share it?)

Files

SMAPI log

The SMAPI log provides useful information for troubleshooting problems. It includes your game and SMAPI version, which mods you have, where the game is installed, any errors that occurred, and what happened.

Here’s how to share it:

  1. Find the log file here:

    Platform Path
    Windows %appdata%\StardewValley\ErrorLogs\SMAPI-latest.txt
    (Paste “%appdata%” into the address bar, Windows knows where it is.)
    Linux ~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt
    (The folder is hidden by default. From Files, click Go » Enter Location and enter “~/.config”.)
    Mac ~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt
    (The folder is hidden by default. From Finder, click Go » Go to Folder and enter “~/.config”.)

    (If you see a MODDED_ProgramLog.Log_LATEST.txt file instead, you have an older version of SMAPI. Try updating to the latest version.)

  2. If you’re sharing it…

Save files

The game puts save files here:

Platform Path
Windows %appdata%\StardewValley\Saves
(Paste “%appdata%” into the address bar, Windows knows where it is.)
Linux ~/.config/StardewValley/Saves
(The folder is hidden by default. From Files, click Go » Enter Location and enter “~/.config”.)
Mac ~/.config/StardewValley/Saves
(The folder is hidden by default. From Finder, click Go » Go to Folder and enter “~/.config”.)

Each save has a folder like JonSnow_123456789, with two main files inside it: JonSnow_123456789 and SaveGameInfo. Both files are needed to load the save.

To share your save, zip the entire JonSnow_123456789 folder and send that.

Game folder

The “game folder” is the folder that contains the Stardew Valley.exe or StardewValley.exe file. The default locations are:

Platform Path
Windows GOG: C:\Program Files (x86)\GalaxyClient\Games\Stardew Valley
Steam: C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley
Linux GOG: ~/GOG Games/Stardew Valley/game
Steam: ~/.local/share/Steam/steamapps/common/Stardew Valley
Mac GOG: /Applications/Stardew Valley.app/Contents/MacOS
Steam: ~/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS

If your game isn’t in the default location, here’s how to find it:

Troubleshooting

Common issues

Let’s run through a quick checklist:

  1. Are you running the latest versions? The versions are listed in the first line of the console window:

    Make sure you have Stardew Valley 1.11 and the latest version of SMAPI.

  2. Are you using a Stardew Valley mod manager? Those are still experimental, so they can cause problems. Try downloading the mod manually.

  3. See the sections below for solutions to specific errors.

Could not load file or assembly ‘Stardew Valley’

That error means SMAPI couldn’t find your Stardew Valley.exe (Windows) or StardewValley.exe (Linux/Mac) file, probably because SMAPI isn’t in the right folder. Make sure you’re running StardewModdingAPI.exe in your game folder, not the one in the downloaded installer folder. See the official install instructions for detailed steps.

Ignored folder “…” which doesn’t have a manifest.json

SMAPI couldn’t find the manifest.json file for the mod in that folder. Common solutions:

  1. If the mod doesn’t have a manifest.json file, it’s not a SMAPI mod so it won’t work from the Mods folder. See that mod’s documentation for setup instructions.

  2. If the mod has a manifest.json file, make sure the files are in a Mods subfolder. For example, the files should look like this:

    Stardew Valley/
       Mods/
          PineapplesEverywhere/
             PineapplesEverywhere.dll
             manifest.json
    

    …and not like this sub-subfolder:

    Stardew Valley/
       Mods/
          PineapplesEverywhere-1.3/
             PineapplesEverywhere/
                PineapplesEverywhere.dll
                manifest.json
    

SEHException: External component has thrown an exception

You may see an error like this with SEHException in the text:

System.Runtime.InteropServices.SEHException (0x80004005): External component has thrown an exception.
   at new[](UInt32 )
   at Microsoft.Xna.Framework.Audio.UnsafeNativeMethods.AllocateArrayAndReadFile(String filename, Void** ppData, UInt32* pdwBufferSize)
   at Microsoft.Xna.Framework.Audio.UnsafeNativeMethods.WaveBank.CreateHandle(UInt32 hEngine, String string, Int32 length, IntPtr& pCleanup)
   at Microsoft.Xna.Framework.Audio.WaveBank..ctor(AudioEngine audioEngine, String nonStreamingWaveBankFilename)
   at StardewValley.Game1.Initialize()
   at StardewModdingAPI.Inheritance.SGame.Initialize() in D:\source\_Stardew\SMAPI\src\StardewModdingAPI\Inheritance\SGame.cs:line 302
   at Microsoft.Xna.Framework.Game.RunGame(Boolean useBlockingRun)
   at Microsoft.Xna.Framework.Game.Run()
   at StardewModdingAPI.Program.StartGame() in D:\source\_Stardew\SMAPI\src\StardewModdingAPI\Program.cs:line 274

That error happens in the game’s audio startup code, which is very sensitive to resources being used before the audio is ready. This isn’t caused by SMAPI directly, though SMAPI uses some extra resources during startup.

Common solutions:

SMAPI contains a trojan?