« back to index

SMAPI FAQ

This page is a quick reference for common questions about SMAPI.

General

How do I use mods? What is SMAPI?

See using mods for an introduction.

How do I create a mod?

See creating a SMAPI mod, which walks you through creating a mod and documents the available events and APIs.

Getting help

Where can I ask for 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.

See also what information should I include in a bug report?

What should I mention 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?)

Where is my error log?

SMAPI’s error log provides information useful for troubleshooting problems, including any errors that occurred.

You can find your error log here:

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

Don’t paste the whole log into your message! Instead attach it as a file, or send a pastebin link.

Other

Where are my 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.

Where is my 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: unknown
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.

FileNotFoundException: 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

An error like this with “Microsoft.Xna.Framework.Audio” 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

…usually means your computer didn’t have enough resources to start the game fast enough (which the game doesn’t handle very well). This typically isn’t caused by SMAPI itself.

Common solutions:

SMAPI contains a trojan?