Stardew valley smapi error

Did something go wrong with your game? This is the page for you. (This page isn’t only for players who use mods!)

The basics

Common fixes

1. Restart your computer.
2. Make sure you have Stardew Valley 1.5.6 or later.
   1. Click the «?» button on the title screen, and the version will appear in the bottom-left.
   2. Right-click on the game’s name in Steam and go to Properties. Check the betas tab, and make sure you are not opted into the 32-bit beta if you are trying to use SMAPI. For more information, see Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_work_with_the_compatibility_branch.
3. Reset your content files.
4. If you use SMAPI:
   1. Make sure you have the latest version of that.
      The SMAPI version is shown at the top of the SMAPI console window.
   2. Upload a log to the log parser, following the instructions on that page to find where your log is stored. It can help you diagnose common errors. Take a look at this annotated log for more information on how to read and understand your log.
      1. If the parser website says the log is too big, or it takes too long to parse, you can open it up in any text editor (Notepad or Notepad++ work; on Mac TextEditor works), then copy from the very top of the log to the bottom of the first couple errors, and parse that.
   3. The very top of your log will show a list of all your mods that need to be updated. You can also use Mod Update Menu to keep track of your updates from the in-game menu. The first thing to try when you’re having issues with mods is to update everything shown there, even if some of the mods seem to be working fine right now.
   4. If you’ve narrowed down the issue to a specific mod or group of mods, try performing a clean reinstall.
      1. Remove all folders for the mod that’s causing the issue, making sure to check the mod page for a list of every folder that’s included. (If you’re downloading mods from Nexus, you can look under «Preview File Contents.» On ModDrop, you can find that information under «Files» on the sidebar.)
      2. Redownload the mod and follow the installation instructions on the mod page. If you normally use a mod manager, reinstall the mod manually to make sure your issue wasn’t caused by the mod manager placing files in the wrong locations.
5. If you still get the error, look through the common issues on this page or ask for help!

Reset your content files

Many problems are caused by broken game files (especially if you use XNB mods). You can reset your game files to fix that. SMAPI mods won’t be affected.

1. See instructions for Steam or for GOG Galaxy.
2. If you use SMAPI on Linux or macOS, reinstall SMAPI to fix the launcher.

more options

If you don’t want to reset all files, you have some other options. Option 2: create retroactive backup to reset any file If you installed XNB mods and want to reset one file you know is broken, you can just restore the original file. If you forgot to back it up, here’s how to recover the original files without losing your modded ones: Copy your game’s Content folder to Content-modded. Reset your game files (see instructions for Steam or for GOG Galaxy). Copy your (now reset) Content folder to Content-backup. Move Content-modded back to Content. Now your content files are still modded, but you have a backup of the original files. Option 3: troubleshoot XNB mods If you installed XNB mods, you’re not sure which caused the problem, and you don’t want to remove all your XNB mods, here’s how to figure out which one is causing the problem. Back up any XNB mods you want to keep. Reset your game files (see instructions for Steam or for GOG Galaxy). Any XNB mods will be removed, but SMAPI mods won’t be affected. If you use SMAPI on Linux or macOS, reinstall SMAPI to fix the launcher. Launch the game to see if the problem is fixed. Reinstall your XNB mods one at a time. After each install, test the game to make sure the mod doesn’t cause problems.

Caution: XNB mods (which replace your game files directly) are no longer recommended and can cause issues. Resetting your content files will remove XNB mods you installed. After doing so, consider using content packs instead.

FAQs about Stardew Valley 1.5.5

Do I need NET 5.0?

You shouldn’t need NET 5.0 to run Stardew Valley 1.5.5+ or SMAPI 3.13.2; Stardew bundles NET 5.0.

What are all these weird files in my game folder?

These are from Stardew Valley 1.5.5 itself, do not delete them! (Stardew now bundles dependencies, that’s what all those files are!)

Are mods updated for 1.5.5?

More than 95% of mods are not broken, per Pathoschild’s official stats, but some are on unofficial updates. For PyTK and TMXL, got to smapi.io/mods and search for their names there, then follow the links to the unofficial updates. For UI Info Suite, get UI Info Suite 2 from searching smapi.io/mods for the link, then going to the sidebar on Github for releases. For Content Patcher, make sure you have the most recent version. For all other mods, check smapi.io/mods for the latest version, which may be an an unofficial update.

Game doesn’t launch

When you try to launch the game, nothing seems to happen or the window closes instantly. (If you use Steam, it might show ‘running’ for a few seconds.)

1. Try common fixes:

1. Restart your computer.
2. Reset your content files or reinstall the game.
4. Delete your startup_preferences file. (To find it: open your saves folder, and it’ll be in the folder that contains it.)
5. Install the software for your graphics card (GeForce Experience for NVIDIA or Radeon Software for AMD), then use that software to update to your latest graphics drivers. (See how to check which graphics card you have.)
6. Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).
7. Delete startup_preferences This can be found on Windows at %appdata% > Stardew Valley > it’s in that folder, or C:UsersYourwindowsnamehereAppDataRoamingStardewValley or for Mac can be found at ~/.config/StardewValley
8. If you use…
   

   system	common fixes
   SMAPI on Windows	If you use Steam, double-check that your Steam launch options match the instructions in the install guide.
   SMAPI on Linux	If you use Steam, make sure your Steam launch options are empty. Your default terminal might not be compatible. Try installing the xterm terminal.
   SMAPI on macOS	If you use Steam, make sure your Steam launch options are empty.

2. (Windows only) Run the game on your dedicated graphics card:

The ‘high performance’ option described in the steps on the left.

Many computers have two options for running games: integrated graphics (part of the processor) and dedicated graphics (a separate graphics card by NVIDIA or AMD). Stardew Valley should be run on the dedicated graphics, but that’s not always the default (especially on laptops). If you’re not sure if this applies to your computer, it’s safe to just try the instructions below anyway — they just won’t do anything if it doesn’t apply.

To fix this:

1. From the start menu, search for Graphics Settings and open it.
2. In the window that opens, click «Browse» near the top and choose  StardewModdingAPI.exe in your game folder (or  Stardew Valley.exe if you play without mods).
3. In the app list, click «Options» under StardewModdingAPI (or Stardew Valley if you play without mods).
4. Change the Graphics preference to «High performance».
5. Save.
6. Check whether it launches fine now.

3. Check if there’s an error message:

1. Open your game folder.
2. Right-click the folder background. On Windows, also hold Shift
3. Click the option that says Open in Command Prompt, Open in PowerShell, Open in Windows Terminal or Open In Terminal (depending on your system settings/OS).
4. Type this command:
   

   if you play…	command
   with mods on Windows	.StardewModdingAPI.exe
   without mods on Windows	."Stardew Valley.exe"
   with mods on Mac/Linux	./StardewModdingAPI
   without mods on Mac/Linux	./"StardewValley"

5. Press enter to run the command.
6. If it shows an error message, check for a section under Specific error messages below.

(note: any command prompt works, including WSL’s, if you don’t like powershell/command prompt.)

4. Ask for help:

If you still haven’t solved it, come Ask for help!

Specific error messages

«Could not load ‘Stardew Valley’ or one of its dependencies»

SMAPI wasn’t able to load the game’s executable. There’s a number of possible reasons for this:

1. Reset your content files.
2. Make sure you have Stardew Valley 1.5.6 or later. (If you’re not sure: launch without mods per step 4 below, click the «?» button on the title screen, and check the bottom-left corner of the screen.)
3. Make sure you have the latest version of SMAPI.
4. Make sure you can launch the game without SMAPI:
   1. Open your game folder.
   2. Double-click  Stardew Valley.exe (on Windows) or StardewValley-original (on Linux/macOS).
   3. If the game doesn’t work either, see game doesn’t launch.
5. Make sure you didn’t enable the «compatibility branch» in Steam or GOG Galaxy (mods don’t work on the compatibility branch).
6. Make sure you’re running  StardewModdingAPI.exe from your game folder (see the install instructions).
7. Did you install SMAPI manually (not using the installer)? Make sure you followed all the steps in the installer’s README.txt file.
8. In rare cases, completely uninstalling then reinstalling the game may be needed.

«The game failed to launch: Microsoft.Xna.Framework.Graphics.NoSuitableGraphicsDeviceException: Failed to create graphics device»

That means your graphics drivers aren’t supported by the underlying game framework.

Common fixes:

1. Update your graphics drivers:

1. Install the app for your graphics card (GeForce Experience for NVIDIA or Radeon Software for AMD). If you’re not sure, see how to check which graphics card you have.
2. Open the app.
3. Find the section that shows graphics driver info. Make sure it says you have the latest version, and install any updates if not.

2. (Windows only) Run the game on your dedicated graphics card:

The ‘high performance’ option described in the steps on the left.

Many computers have two options for running games: integrated graphics (part of the processor) and dedicated graphics (a separate graphics card by NVIDIA or AMD). Stardew Valley should be run on the dedicated graphics, but that’s not always the default (especially on laptops). If you’re not sure if this applies to your computer, it’s safe to just try the instructions below anyway — they just won’t do anything if it doesn’t apply.

To fix this:

1. From the start menu, search for Graphics Settings and open it.
2. In the window that opens, click «Browse» near the top and choose  StardewModdingAPI.exe in your game folder (or  Stardew Valley.exe if you play without mods).
3. In the app list, click «Options» under StardewModdingAPI (or Stardew Valley if you play without mods).
4. Change the Graphics preference to «High performance».
5. Save.
6. Check whether it launches fine now.

3. Use the compatibility branch or an older version of Stardew Valley:

As an absolute last resort, you can…

• Use the Stardew Valley compatibility branch (note that that mods don’t work with that version currently);
• or downgrade to Stardew Valley 1.5.4 or earlier (note that you’ll need to use older versions of SMAPI and many mods).

«Skipped ‘…’ because it doesn’t have a manifest.json»

SMAPI couldn’t find the manifest.json file for the mod in that folder. That usually means it’s not a SMAPI mod, so it won’t work from the Mods folder. See that mod’s documentation for install instructions.

«missing executable» (Steam only)

Steam can’t find the game launcher, usually because your Steam launch options are incorrect. Common fixes:

• If you want to use SMAPI:
  make sure it’s installed and your launch options are correct (see install guide).
• If you’re uninstalling SMAPI:
  1. In Steam, right-click Stardew Valley and choose Properties.
  2. Click the Set Launch Options button.
  3. Make sure the textbox is completely empty.

«Could not load file or assembly»

If the ‘file or assembly’ starts with Microsoft or System (like «FileNotFoundException: Could not load file or assembly ‘System.[…]’ or one of its dependencies«) OR you get something like «The library ‘[…].dll’ required to execute the application is not found in ‘C:Program Filesdotnet`» (often this is hostpolicy.dll), something is wrong with the core frameworks used by the game.

Common fixes:

• Reset the content files.
• If that doesn’t work, uninstall Stardew Valley (and fully delete your game folder) and then reinstall it.
• Check to make sure you don’t accidentally have two copies of the game.

(Stardew now comes packaged with the dependencies needed to run, so you shouldn’t need to install them yourself.)

You may also see an error like this if you installed SMAPI manually (by renaming the .bat to a .zip and moving files yourself). Try reinstalling SMAPI using the installer if that is the case.

OutOfMemoryException errors

Your log shows OutOfMemoryException errors in the console, and the game may severely lag or crash. That means your game ran out of available memory mid-session.

Some common fixes:

• Make sure you have the latest Stardew Valley 1.5.6, which is 64-bit and doesn’t have the 32-bit limitations of older versions.
• If you still get the error, you might need to remove content mods you don’t need (particularly content packs for Custom Music, SAAT or TMXL Map Toolkit, which can use a lot of memory).

SMAPI takes forever to load!

A few main issues can cause this:

• (Windows only) **Make sure the SMAPI window isn’t in select mode** (the SMAPI window will show ‘Select’ in the top-left corner before ‘SMAPI’). This pauses loading so you can see what the console says, enabled when you select any text on the console window. To fix it, just click the console and press the ‘enter’ key a few times.

  

  The ‘select mode’ indicator.

• An antivirus hampering SMAPI in loading up the game. Often this results in larger gaps of time than is usual in the log (several seconds to do a very basic task). You can try disabling your antivirus to check if this is the cause, and if that fixes it, re-enabling the antivirus while whitelisting SMAPI, Stardew Valley, and the game folder.
  • One tip: If you aren’t sure if you have an antivirus, Windows has a built-in one named Windows Defender.
• (Windows only) If you have a dedicated graphics card, run the game on it and not on the integrated graphics card. See above under “Game doesn’t launch” for instructions.
• If you have a lot of mods, you should expect a loading time measured in minutes. The exact loading up time depends heavily on which exact mods you have and what your computer is like. If you have a few very large mods (such as one or more expansion-type mods) you should probably wait a few minutes before deciding something is wrong. If you have PyTK installed but are no longer using it, try removing it to see if this helps the load times.

NoAudioHardwareException: Audio has failed to initialize

This exception means that for whatever reason, either the game or SMAPI cannot use your computer’s audio. A possible fix (for Windows) is installing OpenAl. You can also try plugging in some headphones or connecting a bluetooth headset.

Mac: Contents/MacOS/StardewValley Already Exists

This error looks something like:
«An error occurred in the base update loop: IOException: The file ‘/Users/USERNAME/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS/StardewValley’ already exists.»

If this happens, verify the following:

• Show hidden files in Finder with Command+Shift+., then go to your home directory (named after your username, likely has a little home icon next to it on the left side of Finder). There should be a bunch of hidden folders that show up.
• The folder ~/.config/StardewValley/ErrorLogs exists. If it doesn’t exist, make it exist.
• Your screenshots button works. If it doesn’t work, make sure the folder ~/.local/share/StardewValley/Screenshots exists. If it doesn’t exist, make it exist.

If neither of those fixes works, it’s not clear what to do.

Other issues

Game lags or stutters in-game

There’s a few things you can try.

1. If you use mods:
   1. Update SMAPI and your mods to their latest versions.
   2. Make sure there’s no repeating errors in the SMAPI console window (if there are, see get help).
   3. Temporarily remove all mods except SMAPI and Error Handler. If that fixes it, one of your mods might be causing lag. (You can still try the other fixes below to see if they help.)
2. For Windows players only, run the game on your dedicated graphics card (see subsection 2).
3. For Linux/SteamDeck players: if you’ve suppressed the console, consider also suppressing console input.
4. Add an exception in your antivirus software for the Stardew Valley folder. You can search online for your antivirus name with the words add folder exception for instructions.
   Note for Windows players: if didn’t install an antivirus, you have Windows Defender by default and it can cause lag. Try excluding the game folder in that case.
5. Set the processor affinity for  StardewModdingAPI.exe (if using mods) or  Stardew Valley.exe (without mods) to 2 or higher.
6. Set the process priority for  StardewModdingAPI.exe (if using mods) or  Stardew Valley.exe (without mods) to High.
7. If you own the Steam version of the game, try launching the game through the Steam client.

If you’re still having issues after that, see get help.

Game audio doesn’t play or audio is distorted (Windows only)

Audio plays fine in your browser or other apps, but the game is silent. Here are some common fixes:

1. Restart your computer.
2. Make sure the Windows mixer isn’t muting the game.
3. Make sure the in-game sound slider options aren’t muted.
4. Check the debugging options under «Game doesn’t launch».
5. Check for a NoAudioHardwareException and follow instructions there

Game resolution changes when launched with SMAPI (Windows only)

Everything looks bigger/smaller if you launch the game with SMAPI.

Updating to SMAPI 3.16.0 or later should fix this. If not, please ask for help.

Save disappeared or doesn’t load

See Saves#Troubleshooting.

Can’t connect to another player in multiplayer

1. Check your game setup:
   1. Make sure you have the latest Stardew Valley version (1.5.6 on PC).
   2. Make sure the host (main player) is in co-op mode. They need to click the Co-op button on the title screen, and launch the save by clicking «Host (farmname) Farm». Loading a save through the regular load game menu, even if cabins have been built, will launch it in single-player mode.
   3. Make sure you have enough cabins built for the number of players.
   4. Make sure the server is set to online in the game options.
   5. Reset the content files for all players.
   6. Delete your startup_preferences (found in %appdata%/StardewValley on Windows or ~/.config/StardewValley on Linux/Mac).
2. Make sure everyone launches the game through Steam or GOG Galaxy (not a separate shortcut). For SMAPI on Windows, see Configure your game client in the Windows install guide.
3. Turn off firewalls and antiviruses for all players. If you have more than one antivirus, that’s very likely the cause. Never use more than one antivirus at a time.
4. Restart all players’ PCs.
5. Restart all players’ routers, and check for any updates for your router.
6. If you don’t see the ‘enter invite code’ option, your Steam name may have been flagged as inappropriate. Try changing it and re-launching the game.
7. (Windows only) Check the debugging steps under Game doesn’t launch.
8. If you use mods and are getting a «version mismatch» error, check your log files for a line like [19:49:26 TRACE game] Starting server. Protocol version: 1.5.6 and check whether the protocol version matches.

For console players, please try all of the steps that apply (particularly the first four under ‘check your game setup’) and try power cycling your console. Please note that all consoles require their paid online service to play over the internet.

SMAPI files disappear or antivirus complains

Your antivirus might remove or report SMAPI/mod files. This is almost always a false positive, meaning the files don’t contain a trojan.

How can I know if it’s actually safe?

Nothing on the Internet is guaranteed, but SMAPI itself is most likely safe — you can check by reading the code, decompiling the download, or uploading it to VirusTotal. (VirusTotal scans the file with sixty or so antiviruses; if only one or two detect an issue, it’s most likely a false positive.)

For mods, you can check by decompiling them or uploading to VirusTotal too. Note that every file downloaded from Nexus Mods is scanned before it’s available.

Why does this happen?

Antiviruses are usually concerned because…

• The download is still new. In this case it didn’t really detect anything, it’s just worried because it’s an unknown file. Antiviruses often show a fake trojan name like Trojan:Win32/Emali.A!cl for this. Antiviruses learn to allow it after enough users download it, but that resets for each release.
• Antiviruses may check for certain patterns like accessing files or rewriting code, which are both things SMAPI mods do as part of their normal functionality (since changing the game is the whole point).

How can I install SMAPI or the mod if my antivirus flags it?

• One option is to just wait a few days before downloading a new update (or a few weeks for a less popular mod). By then enough users should have downloaded it to reduce antivirus alerts.
• If you’ve checked that it’s safe above, another option is to…
  1. Temporarily disable your antivirus.
  2. Redownload and install SMAPI or the mod.
  3. Add an exception to your antivirus for the Stardew Valley folder (search online for your antivirus name with the words add folder exception for instructions).

SMAPI doesn’t recognize controller (Steam only)

Common fixes:

1. Launch the game through Steam.
2. Windows only: make sure you set the launch options (see Configure your game client in the Windows install guide), don’t add SMAPI as a non-Steam game.
3. If all else fails, you can use third-party software to add controller support. Suggested software:
   • Linux: SC Controller.
   • Mac: 360Controller. When using a non-Xbox controller, you should enable ‘pretend to be an Xbox 360 controller’. (In some cases, you may need to enable it even for an Xbox controller.)
   • Windows: reWASD (not free after trial period) or InputMapper (free but more complicated) to remap your controller as an Xbox controller.

last resort on Linux/Mac

As a last resort on Linux or Mac, you can disable the SMAPI console window to fix this. You won’t see update/error alerts unless you check the log, and your game won’t launch after a crash until you delete the smapi-internal/StardewModdingAPI.crash.marker file. You should periodically check the log to make sure everything is working correctly. If you really want to do this: On Linux or macOS: Find your game folder. Open the StardewValley file (the one with no file extension) in a text editor. Change SKIP_TERMINAL=false near the top to SKIP_TERMINAL=true. On Windows: disabling the console window isn’t possible. You’ll need to repeat this after updating SMAPI.

Cursor gets stuck on museum or build screen

When placing items in the museum or placing buildings on the farm, the cursor gets stuck in one spot and snaps back whenever you try to move it.

That happens when the game doesn’t detect the gamepad mode correctly. To fix it:

1. Load your save.
2. Open the in-game menu and go to the options.
3. Set the Gamepad Mode option to either Force On (if you use a controller) or Force Off (if you use a keyboard and mouse).

After updating to the latest versions, launching the game still shows an old SMAPI or game version

That usually means you have two copies of the game: one copy you updated, and another you’re actually playing.

To check if that’s the issue:

1. Launch the SMAPI installer again, and note the «Game path» shown on the first screen:
   
2. Launch the game with SMAPI, and note the «Mods go here» path shown at the top of the output:
   
3. If the two paths are not identical (except for the /Mods part), then you have two game folders.

If you have multiple copies installed, the best solution is to only have one. To do that:

1. Make a copy of your Mods folder somewhere else.
2. Uninstall the game.
3. Delete both folders you found above.
4. Reinstall the game through Steam or GOG Galaxy.
5. Reinstall SMAPI, which should now detect your single game path.
6. Copy your mods back into the new game folder.

more options
If having multiple copies of the game is deliberate, you can also copy the SMAPI installer into a subfolder of the game folder you want to update. When you run it, it’ll detect the parent folder automatically and update that one.

SMAPI installer opens, then immediately closes

Q: The installer opens for a second, then immediately closes.

A: Make sure you’re installing SMAPI 3.13.1 or later, which fixed an issue with path names. If you are, try whitelisting the SMAPI installer with your antivirus, and redownload, as your SMAPI installer may have been mangled by your antivirus. If that still doesn’t work try these steps:

1. Open the installer folder.
2. Hold shift and right-click on the folder background.
3. Click the option that says Open in command prompt / PowerShell / Windows Terminal (depending on your Windows settings).
4. Run "install on Windows.bat" (if Command Prompt) or ./"install on Windows.bat" (if PowerShell or Windows Terminal).
5. Now if it crashes, the window should stay open so you can see the error.
6. Post a screenshot of the full window when it shows the error in the #using-mods discord channel for debugging help.

Two copies of saves

Try uninstalling Get Glam if you have it installed.

Pet event repeating over and over

You probably have a pet named the same thing as an NPC in the game, most likely a modded NPC (both reported instances have been Stardew Valley Expanded NPC names). Save editing to remove your pet may help, but is tricky and difficult. Narrowing down the cause of this issue has been somewhat difficult. You can try naming the pet something other than the name of an NPC, or rejecting the pet, and see if that helps, but you may end up with multiple pets.

Known issues

SMAPI doesn’t work with the compatibility branch

What is the compatibility branch?

There’s two versions of Stardew Valley 1.5.6: the newer 64-bit main branch which is installed by default, and a legacy 32-bit compatibility branch for older systems. These have identical content for players, but use different frameworks.

Why don’t mods work with it?

Unfortunately SMAPI only supports the main branch of the game currently. There are formidable difficulties across all mods in supporting all three variations, 32-bit imposes significant restrictions on what mods can do, and the Steam hardware stats show that ≈99.69% of players have 64-bit.

Having multiple versions of SMAPI (like we do for Linux/macOS/Windows compatibility) wouldn’t be enough in this case. Every C# mod author would need to manually port two versions of every update of every mod forever, which is prohibitively unfeasible. It’s possible that in the future we’ll either figure out how SMAPI can automatically rewrite mods for the compatibility branch, or some modders may port SMAPI and individual mods to the compatibility branch.

How can I play if I can’t update to the latest versions?

You have a few options.

1. First, make sure you really can’t update. Over 99% of systems should be compatible with the main branch; it’s only very old system that are 32-bit-only or use unsupported graphics cards that might not work.
2. Or you can switch to the game’s compatibility branch without mods. Mods don’t work with it currently, but it’ll continue receiving the same content updates backported to the older frameworks for players with older systems.

3. Or you can rollback to the previous Stardew Valley 1.5.4, so you can continue playing like before. The newest mod updates won’t work for you, but you’ll be able to install any mod updates up to 29 November 2021. If (or when) we figure out how to make mods work with the compatibility branch in the future, then you’d be able to switch to the compatibility branch instead.

   If you want to rollback to Stardew Valley 1.5.4, here’s how:

   Please note this only works on the Steam version of the game!

   1. Install .NET 5 or later.
   2. Download the latest DepotDownloader release.
   3. Open a command prompt in the DepotDownloader folder.
   4. Run this command (replace <username> and <password> with your Steam login):

      dotnet DepotDownloader.dll -app 413150 -depot 413151 -manifest 7802000804251603756 -username <username> -password <password>

   5. Install SMAPI in the downloaded folder and move your mods over.
   6. Launch StardewModdingAPI.exe in the downloaded folder.

4. Or use a tool called DepotDLGUI designed to download 1.5.4 more easily using DepotDownloader.

   Please note this only works on the Steam version of the game!

   1. Install .NET 5.
   2. Download the latest release of DepotDLGui. (Green Price Tag on the right side of the screen, under the word Releases)
   3. Unzip the file you just downloaded.
   4. Run DepotDLGUI_cs.exe
   5. Install SMAPI in the downloaded folder (depots4131518043676)and move your mods over.
   6. Launch StardewModdingAPI.exe in the downloaded folder.

Get help

Report a bug

If you play without mods

See this guide to fixing your game. If you still need help, ask for help.

If you play with mods

First, check whether it happens without mods too:

1. Open your game folder.
2. Double-click  Stardew Valley.exe (on Windows) or StardewValley-original (on Linux/macOS) to launch the game.

If it only happens with mods installed, ask for help. Otherwise see If you play without mods above.

Ask for help

See Modding:Help for how to get help!

Did something go wrong with your game? This is the page for you. (This page isn’t only for players who use mods!)

Common fixes

The basics

1. Restart your computer.
2. Make sure you have Stardew Valley 1.5.4 or later.
   Click the «?» button on the title screen, and the version will appear in the bottom-left.
3. Reset your content files.
4. If you use SMAPI:
   1. Make sure you have the latest version of that.
      The SMAPI version is shown at the top of the SMAPI console window.
   2. Upload a log to the log parser, following the instructions on that page to find where your log is stored. It can help you diagnose common errors. Take a look at this annotated log for more information on how to read and understand your log.
   3. The very top of your log will show a list of all your mods that need to be updated. You can also use Mod Update Menu to keep track of your updates from the in-game menu. The first thing to try when you’re having issues with mods is to update everything shown there, even if some of the mods seem to be working fine right now.
   4. If you’ve narrowed down the issue to a specific mod or group of mods, try performing a clean reinstall.
      1. Remove all folders for the mod that’s causing the issue, making sure to check the mod page for a list of every folder that’s included. (If you’re downloading mods from Nexus, you can look under «Preview File Contents.» On ModDrop, you can find that information under «Files» on the sidebar.)
      2. Redownload the mod and follow the installation instructions on the mod page. If you normally use a mod manager, reinstall the mod manually to make sure your issue wasn’t caused by the mod manager placing files in the wrong locations.
5. If you still get the error, look through the common issues on this page or ask for help!

Reset your content files

Many problems are caused by broken game files (especially if you use XNB mods). You can reset your game files to fix that. SMAPI mods won’t be affected.

1. See instructions for Steam or for GOG Galaxy.
2. If you use SMAPI on Linux/Mac, reinstall SMAPI to fix the launcher.

more options

If you don’t want to reset all files, you have some other options. Option 2: create retroactive backup to reset any file If you installed XNB mods and want to reset one file you know is broken, you can just restore the original file. If you forgot to back it up, here’s how to recover the original files without losing your modded ones: Copy your game’s Content folder to Content-modded. Reset your game files (see instructions for Steam or for GOG Galaxy). Copy your (now reset) Content folder to Content-backup. Move Content-modded back to Content. Now your content files are still modded, but you have a backup of the original files. Option 3: troubleshoot XNB mods If you installed XNB mods, you’re not sure which caused the problem, and you don’t want to remove all your XNB mods, here’s how to figure out which one is causing the problem. Back up any XNB mods you want to keep. Reset your game files (see instructions for Steam or for GOG Galaxy). Any XNB mods will be removed, but SMAPI mods won’t be affected. If you use SMAPI on Linux/Mac, reinstall SMAPI to fix the launcher. Launch the game to see if the problem is fixed. Reinstall your XNB mods one at a time. After each install, test the game to make sure the mod doesn’t cause problems.

Caution: XNB mods (which replace your game files directly) are no longer recommended and can cause issues. Resetting your content files will remove XNB mods you installed. After doing so, consider using content packs instead.

Fix common problems

Game doesn’t launch

The game doesn’t open when you try to launch it. (If you use Steam, it might show ‘running’ for a few seconds.) Here are some common fixes:

1. Restart your computer.
2. Make sure you have speakers or headphones plugged in. (They can be muted, but the game needs a working audio device.)
3. If you play on Windows:
   1. Install (or reinstall) .NET Framework 4.5.2 and XNA Framework 4.0. You may need to remove .NET first.
   2. Restart your computer.
   3. Launch the game.
4. If you play on Linux:
   1. Your default terminal might not be compatible. Try installing the xterm terminal.
5. If that doesn’t fix it:
   1. Install SMAPI (if you don’t already have it).
   2. Launch the game.
   3. Ask for help and attach your SMAPI log.

Game freezes or crashes while opening

The game tries to open, but crashes before the title screen. Here are some common fixes:

1. Try everything in the list above first.
2. Delete your startup_preferences, found in %appdata%/StardewValley on Windows.
3. Disable antivirus if using SMAPI.
4. Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).
5. If that doesn’t fix it, follow the steps to ask for help.

Game audio doesn’t play (Windows only)

Audio plays fine in your browser or other apps, but the game is silent. Here are some common fixes:

1. Restart your computer.
2. Make sure the Windows mixer isn’t muting the game.
3. Make sure the in-game sound slider options aren’t muted.
4. Reinstall .NET Framework 4.5.2 and XNA Framework 4.0.

Save disappeared or doesn’t load

See Saves#Troubleshooting.

Can’t connect to another player in multiplayer

1. Check that Stardew Valley is up to date and your save is loaded in co-op mode. The host needs to go to the Co-op tab in the main menu and launch the save by clicking «Host (farmname) Farm». Loading a save through the regular load game menu, even if cabins have been built, will launch it in singleplayer.
2. Make sure you have enough cabins built for the number of players.
3. Make sure everyone launches the game through Steam or GOG Galaxy (not a separate shortcut). On Windows, see Launch SMAPI through Steam or GOG Galaxy in the Windows install guide.
4. Make sure the server is set to online in the game options.
5. Turn firewalls and antivirus off for all players. If you have more than one antivirus, that’s very likely the cause. Never use more than one antivirus at a time.
6. Do a content reset for all players.
7. Delete your startup_preferences (found in %appdata%/StardewValley on Windows or ~/.config/StardewValley on Linux/Mac).
8. Restart all players’ PCs.
9. Restart all players’ routers, and check for any updates for your router.
10. If you don’t see the ‘enter invite code’ option, your Steam name may have been flagged as inappropriate. Try changing it and re-launching the game.
11. (Windows only) Try reinstalling .NET Framework 4.5.2 and XNA Framework 4.0 first and Visual C++ Redistributable Packages for Visual Studio 2013 if that fails.
12. If you use mods and are getting a «version mismatch» error, check your log files for a line like [19:49:26 TRACE game] Starting server. Protocol version: 1.4.0.1 and check whether the protocol version matches.

For console players, please try as many of the steps as you can (particularly the first three) and try power cycling your console. Please note that all consoles require their paid online service to play over the internet.

SMAPI files disappear or antivirus complains

Your antivirus might remove or report SMAPI/mod files. This is almost always a false positive, meaning the files don’t contain a trojan.

How can I know if it’s actually safe?

Nothing on the Internet is guaranteed, but SMAPI itself is most likely safe — you can check by reading the code, decompiling the download, or uploading it to VirusTotal.

For mods, you can check by decompiling them or uploading to VirusTotal too. Note that every file downloaded from Nexus Mods is scanned before it’s available.

Why does this happen?

Antiviruses are usually concerned because…

• The download is still new. In this case it didn’t really detect anything, it’s just worried because it’s an unknown file. Antiviruses often show a fake trojan name like Trojan:Win32/Emali.A!cl for this. Antiviruses learn to allow it after enough users download it, but that resets for each release.
• Antiviruses may check for certain patterns like accessing files or rewriting code, which are both things SMAPI mods do as part of their normal functionality (since changing the game is the whole point).

How can I install SMAPI or the mod if my antivirus flags it?

• One option is to just wait a few days before downloading a new update (or a few weeks for a less popular mod). By then enough users should have downloaded it to reduce antivirus alerts.
• If you’ve checked that it’s safe above, another option is to…
  1. Temporarily disable your antivirus.
  2. Redownload and install SMAPI or the mod.
  3. Add an exception to your antivirus for the Stardew Valley folder (search online for your antivirus name with the words add folder exception for instructions).

SMAPI doesn’t recognize controller (Steam only)

Common fixes:

1. Launch the game through Steam.
2. Windows only: make sure you set the launch options (see Launch SMAPI through Steam or GOG Galaxy in the Windows install guide), don’t add SMAPI as a non-Steam game.
3. If all else fails, you can use third-party software to add controller support. Suggested software:
   • Linux: SC Controller.
   • Mac: 360Controller. When using a non-Xbox controller, you should enable ‘pretend to be an Xbox 360 controller’. (In some cases, you may need to enable it even for an Xbox controller.)
   • Windows: reWASD (not free after trial period) or InputMapper (free but more complicated) to remap your controller as an Xbox controller.

last resort on Linux/Mac

As a last resort on Linux or Mac, you can disable the SMAPI console window to fix this. You won’t see update/error alerts unless you check the log, and your game won’t launch after a crash until you delete the smapi-internal/StardewModdingAPI.crash.marker file. You should periodically check the log to make sure everything is working correctly. If you really want to do this: Linux: Find your game folder. Open the StardewValley file (the one with no file extension) in a text editor. Remove the entire section under # open SMAPI in terminal (up to the next fi line). Find this text at the bottom: if [ $? -eq 127 ]; then $LAUNCHER --no-terminal fi And change it to this: $LAUNCHER --no-terminal Mac: Find your game folder. Open the StardewValley file (the one with no file extension) in a text editor. Find this text: open -a Terminal ./StardewModdingAPI.bin.osx [email protected] And change it to this: ./StardewModdingAPI.bin.osx [email protected] 2>&1 > /dev/null Windows: disabling the console window isn’t possible. You’ll need to repeat this after updating SMAPI.

After updating to the latest versions, launching the game still shows an old SMAPI or game version

That usually means you have two copies of the game: one copy you updated, and another you’re actually playing.

To check if that’s the issue:

1. Launch the SMAPI installer again, and note the «Game path» shown on the first screen:
   
2. Launch the game with SMAPI, and note the «Mods go here» path shown at the top of the output:
   
3. If the two paths are not identical (except for the /Mods part), then you have two game folders.

If you have multiple copies installed, the best solution is to only have one. To do that:

1. Make a copy of your Mods folder somewhere else.
2. Uninstall the game.
3. Delete both folders you found above.
4. Reinstall the game through Steam or GOG Galaxy.
5. Reinstall SMAPI, which should now detect your single game path.
6. Copy your mods back into the new game folder.

more options
If having multiple copies of the game is deliberate, you can also copy the SMAPI installer into a subfolder of the game folder you want to update. When you run it, it’ll detect the parent folder automatically and update that one.

Fix specific errors

«SMAPI can’t find the game»

• Make sure you’re running StardewModdingAPI.exe in your game folder (see the install instructions).
• Did you install SMAPI manually (not using the installer)? Make sure you copied the right files: internal/Windows for Windows, or internal/Mono for Linux/Mac.

«Skipped ‘…’ because it doesn’t have a manifest.json»

SMAPI couldn’t find the manifest.json file for the mod in that folder. That usually means it’s not a SMAPI mod, so it won’t work from the Mods folder. See that mod’s documentation for install instructions.

«missing executable» (Steam only)

Steam can’t find the game launcher, usually because your Steam launch options are incorrect. Common fixes:

• If you want to use SMAPI:
  make sure it’s installed and your launch options are correct (see install guide).
• If you’re uninstalling SMAPI:
  1. In Steam, right-click Stardew Valley and choose Properties.
  2. Click the Set Launch Options button.
  3. Make sure the textbox is completely empty.

«looks like Mono isn’t installed» (Linux/Mac only)

Mono is a framework needed by the installer and SMAPI to work correctly. Installing Mono and restarting your computer usually fixes this error.

On Mac, it might not work after installing Mono. If so:

• Enter this command:

  ln -s /Library/Frameworks/Mono.framework/Versions/Current/bin/mono /usr/local/bin/mono
  

• If that shows an error or it still doesn’t work, you can install Homebrew and run brew install mono mono-libgdiplus in the Terminal app.

Could not load file or assembly

If the ‘file or assembly’ starts with Microsoft or System (like «FileNotFoundException: Could not load file or assembly ‘System.[…]’ or one of its dependencies«), something is wrong with the core frameworks used by the game.

1. Common fixes:
   

   platform	reinstall frameworks
   Windows	reinstall .NET Framework 4.5.2 and XNA Framework 4.0 (those exact versions).
   Linux	reinstall mono-complete.
   Mac	reinstall Mono (either channel is fine).

2. On Windows only, in rare cases that won’t fix the issue. Unfortunately that’s hard to fix since .NET Framework is part of Windows itself. In those cases you may need to perform a Windows reset (you can keep your files), or perform a clean reinstall of Windows. This is drastic, but should fix the issue.

Game freezes when loading a save (Mac only)

On Mac only, the game may freeze when you create or load a save; reinstalling Mono (either version) usually fixes that. If it doesn’t, ask for help!

Game resolution changes when launched with SMAPI (Windows only)

Everything looks bigger/smaller if you launch the game with SMAPI. This is usually due to Windows DPI settings.

Common fix:

1. Right-click on StardewModdingAPI.exe, go to Properties > Compatibility > Change High DPI settings, and keep it open.
2. Right-click on StardewValley.exe, and go to Properties > Compatibility > Change High DPI settings.
3. Change the DPI settings for StardewModdingAPI.exe so they match the ones for StardewValley.exe.

Fix other problems

Run the game without SMAPI by launching Stardew Valley.exe (on Windows) or StardewValley-original (on Linux/Mac) in your game folder.

• If it still happens without SMAPI: see this guide to fixing your game. If you still need help, ask for help.
• If it only happens with SMAPI, ask for help.

Ask for help

See Modding:Help for how to get help!

• #1

Hi! Whenever I’m trying to install SMAPI, this text comes up:

Oops, couldn’t find the game automatically.

Type the file path to the game directory (the one containing ‘Stardew Valley.dll’), then press enter.

How do I fix this?

• #2

The way I’ve found to fix this is to open up the properties tab of the Stardew Valley shortcut (assuming it’s been made into a shortcut on your desktop) and copying the location. then right click in the SMAPI Installer to paste it and add

Stardew Valley.dll

This should fix the issue!

• #3

It worked!

Thank you so much!

The way I’ve found to fix this is to open up the properties tab of the Stardew Valley shortcut (assuming it’s been made into a shortcut on your desktop) and copying the location. then right click in the SMAPI Installer to paste it and add

Stardew Valley.dll

This should fix the issue!

• #4

Just finished installing SMAPI and had this same issue. If you have Stardew on Steam then copy paste this into the Installer.

D:SteamLibrarysteamappscommonStardew ValleyStardew Valley.dll

• #5

Cada vez que intento descargar smapi, no me deja.
Escriba la ruta del archivo al directorio del juego (el que contiene ‘Stardew Valley.dll’), luego presione enter.
/Users/luciahierrezuelo/DesktopStardew Valley.dll

y he probado a pegar las ubicaciones de los archivos pero sigue sin funcionar, pero debe ser porque lo estoy probando en un mac

help!!

• #6

Hi, I seem to have the same problem as Chripp and am following ArcticFern’s instructions but i don’t know how to copy the location. Can anybody who knows hot to do this help pls.

The way I’ve found to fix this is to open up the properties tab of the Stardew Valley shortcut (assuming it’s been made into a shortcut on your desktop) and copying the location. then right click in the SMAPI Installer to paste it and add

Stardew Valley.dll

This should fix the issue!

• #7

Hi, I seem to have the same problem as Chripp and am following ArcticFern’s instructions but i don’t know how to copy the location. Can anybody who knows hot to do this help pls.

*how

• #8

Might I suggest putting the install files directly into the mod or stardew valley folder? Also, the location should appear after you right click and select properties. Then I think its as simple as dragging over the text while holding left click. Hope this helped!

Edit: The reason I say put the install files in the folder is as it normally auto detects for me whenever I do this.

• #9

Might I suggest putting the install files directly into the mod or stardew valley folder? Also, the location should appear after you right click and select properties. Then I think its as simple as dragging over the text while holding left click. Hope this helped!

Edit: The reason I say put the install files in the folder is as it normally auto detects for me whenever I do this.

ok, tysm. i’ll try that.

• #10

Might I suggest putting the install files directly into the mod or stardew valley folder? Also, the location should appear after you right click and select properties. Then I think its as simple as dragging over the text while holding left click. Hope this helped!

Edit: The reason I say put the install files in the folder is as it normally auto detects for me whenever I do this.

HI, i can’t seem to be able to drag-click on the target.

• #11

HI, i can’t seem to be able to drag-click on the target.

Are you on mac or Windows? That might be the problem.

• #13

Are you on mac or Windows? That might be the problem.

im on windows

• #14

Hi, I’m having the same issue as chirpp and i’ve tried everything i saw suggested here but nothing is working i have no clue what to do
I’m also on windows
if anyone knows any other way to fix it pls let me know

• 

  17.7 KB
  Views: 137

• #15

Hi, I’m having the same issue as chirpp and i’ve tried everything i saw suggested here but nothing is working i have no clue what to do
I’m also on windows
if anyone knows any other way to fix it pls let me know

Hi, thanks for the screenshot.
You don’t need to type out the Stardew Valley.dll part.

SMAPI just wants you to type out the folder location of that file. After doing so; SMAPI will verify the folder contains that .dll file itself.

• #16

Hi, thanks for the screenshot.
You don’t need to type out the Stardew Valley.dll part.

SMAPI just wants you to type out the folder location of that file. After doing so; SMAPI will verify the folder contains that .dll file itself.

hi thanks for replying! i hope this actually replies directly idk how to use this yet but i tried again and it still didnt work but i got a new message
im not sure what it needs me to do bc my game is all up to date as far as i know? is it just not gonna work?
thank you for your help i appreciate it alot !!

• 

  32.5 KB
  Views: 96

• #17

hi thanks for replying! i hope this actually replies directly idk how to use this yet but i tried again and it still didnt work but i got a new message
im not sure what it needs me to do bc my game is all up to date as far as i know? is it just not gonna work?
thank you for your help i appreciate it alot !!

Omg my bad it took me alot more googling but i figured it out T_T thank you again for taking the time to answer i finally got it

• #18

Omg my bad it took me alot more googling but i figured it out T_T thank you again for taking the time to answer i finally got it

No worries; I’m glad I could help a bit! And nice work figuring out the compat branch stuff.

• #19

bruv ive tried all of the sugestions but still it won t work it shows me the same message every time

• 

  14.9 KB
  Views: 25

• #20

bruv ive tried all of the sugestions but still it won t work it shows me the same message every time

If you go into Steam, right-click Stardew Valley. Then scroll to «Manage» -> «Browse Local Files».
It will open the game folder.
Is that the same path you’re entering?

Modding:Player Guide/Troubleshooting

Did something go wrong with your game? This is the page for you. (This page isn’t only for players who use mods!)

Contents

Common fixes

The basics

1. Restart your computer.
2. Make sure you have Stardew Valley 1.5.4 or later.
   Click the «?» button on the title screen, and the version will appear in the bottom-left.
3. Reset your content files.
4. If you use SMAPI:
   1. Make sure you have the latest version of that.
      The SMAPI version is shown at the top of the SMAPI console window.
   2. Upload a log to the log parser, following the instructions on that page to find where your log is stored. It can help you diagnose common errors. Take a look at this annotated log for more information on how to read and understand your log.
   3. The very top of your log will show a list of all your mods that need to be updated. You can also use Mod Update Menu to keep track of your updates from the in-game menu. The first thing to try when you’re having issues with mods is to update everything shown there, even if some of the mods seem to be working fine right now.
   4. If you’ve narrowed down the issue to a specific mod or group of mods, try performing a clean reinstall.
      1. Remove all folders for the mod that’s causing the issue, making sure to check the mod page for a list of every folder that’s included. (If you’re downloading mods from Nexus, you can look under «Preview File Contents.» On ModDrop, you can find that information under «Files» on the sidebar.)
      2. Redownload the mod and follow the installation instructions on the mod page. If you normally use a mod manager, reinstall the mod manually to make sure your issue wasn’t caused by the mod manager placing files in the wrong locations.
5. If you still get the error, look through the common issues on this page or ask for help!

Reset your content files

Many problems are caused by broken game files (especially if you use XNB mods). You can reset your game files to fix that. SMAPI mods won’t be affected.

1. See instructions for Steam or for GOG Galaxy.
2. If you use SMAPI on Linux/Mac, reinstall SMAPI to fix the launcher.

more options

If you don’t want to reset all files, you have some other options. Option 2: create retroactive backup to reset any file If you installed XNB mods and want to reset one file you know is broken, you can just restore the original file. If you forgot to back it up, here’s how to recover the original files without losing your modded ones: Copy your game’s Content folder to Content-modded . Reset your game files (see instructions for Steam or for GOG Galaxy). Copy your (now reset) Content folder to Content-backup . Move Content-modded back to Content . Now your content files are still modded, but you have a backup of the original files. Option 3: troubleshoot XNB mods If you installed XNB mods, you’re not sure which caused the problem, and you don’t want to remove all your XNB mods, here’s how to figure out which one is causing the problem. Back up any XNB mods you want to keep. Reset your game files (see instructions for Steam or for GOG Galaxy). Any XNB mods will be removed, but SMAPI mods won’t be affected. If you use SMAPI on Linux/Mac, reinstall SMAPI to fix the launcher. Launch the game to see if the problem is fixed. Reinstall your XNB mods one at a time. After each install, test the game to make sure the mod doesn’t cause problems.

Fix common problems

Game doesn’t launch

The game doesn’t open when you try to launch it. (If you use Steam, it might show ‘running’ for a few seconds.) Here are some common fixes:

1. Restart your computer.
2. Make sure you have speakers or headphones plugged in. (They can be muted, but the game needs a working audio device.)
3. If you play on Windows:
   1. Install (or reinstall) .NET Framework 4.5.2 and XNA Framework 4.0. You may need to remove .NET first.
   2. Restart your computer.
   3. Launch the game.
4. If you play on Linux:
   1. Your default terminal might not be compatible. Try installing the xterm terminal.
5. If that doesn’t fix it:
   1. Install SMAPI (if you don’t already have it).
   2. Launch the game.
   3. Ask for help and attach your SMAPI log.

Game freezes or crashes while opening

The game tries to open, but crashes before the title screen. Here are some common fixes:

1. Try everything in the list above first.
2. Delete your startup_preferences , found in %appdata%/StardewValley on Windows.
3. Disable antivirus if using SMAPI.
4. Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).
5. If that doesn’t fix it, follow the steps to ask for help.

Game audio doesn’t play (Windows only)

Audio plays fine in your browser or other apps, but the game is silent. Here are some common fixes:

Save disappeared or doesn’t load

Can’t connect to another player in multiplayer

1. Check that Stardew Valley is up to date and your save is loaded in co-op mode. The host needs to go to the Co-op tab in the main menu and launch the save by clicking «Host (farmname) Farm». Loading a save through the regular load game menu, even if cabins have been built, will launch it in singleplayer.
2. Make sure you have enough cabins built for the number of players.
3. Make sure everyone launches the game through Steam or GOG Galaxy (not a separate shortcut). On Windows, see Launch SMAPI through Steam or GOG Galaxy in the Windows install guide.
4. Make sure the server is set to online in the game options.
5. Turn firewalls and antivirus off for all players. If you have more than one antivirus, that’s very likely the cause. Never use more than one antivirus at a time.
6. Do a content reset for all players.
7. Delete your startup_preferences (found in %appdata%/StardewValley on Windows or

/.config/StardewValley on Linux/Mac).

Restart all players’ PCs.

Restart all players’ routers, and check for any updates for your router.

If you don’t see the ‘enter invite code’ option, your Steam name may have been flagged as inappropriate. Try changing it and re-launching the game.

(Windows only) Try reinstalling .NET Framework 4.5.2 and XNA Framework 4.0 first and Visual C++ Redistributable Packages for Visual Studio 2013 if that fails.

If you use mods and are getting a «version mismatch» error, check your log files for a line like [19:49:26 TRACE game] Starting server. Protocol version: 1.4.0.1 and check whether the protocol version matches.

For console players, please try as many of the steps as you can (particularly the first three) and try power cycling your console. Please note that all consoles require their paid online service to play over the internet.

SMAPI files disappear or antivirus complains

Your antivirus might remove or report SMAPI/mod files. This is almost always a false positive, meaning the files don’t contain a trojan.

How can I know if it’s actually safe? Nothing on the Internet is guaranteed, but SMAPI itself is most likely safe — you can check by reading the code, decompiling the download, or uploading it to VirusTotal. For mods, you can check by decompiling them or uploading to VirusTotal too. Note that every file downloaded from Nexus Mods is scanned before it’s available. Why does this happen? Antiviruses are usually concerned because.

• The download is still new. In this case it didn’t really detect anything, it’s just worried because it’s an unknown file. Antiviruses often show a fake trojan name like Trojan:Win32/Emali.A!cl for this. Antiviruses learn to allow it after enough users download it, but that resets for each release.
• Antiviruses may check for certain patterns like accessing files or rewriting code, which are both things SMAPI mods do as part of their normal functionality (since changing the game is the whole point).

How can I install SMAPI or the mod if my antivirus flags it?

• One option is to just wait a few days before downloading a new update (or a few weeks for a less popular mod). By then enough users should have downloaded it to reduce antivirus alerts.
• If you’ve checked that it’s safe above, another option is to.
  1. Temporarily disable your antivirus.
  2. Redownload and install SMAPI or the mod.
  3. Add an exception to your antivirus for the Stardew Valley folder (search online for your antivirus name with the words add folder exception for instructions).

SMAPI doesn’t recognize controller (Steam only)

1. Launch the game through Steam.
2. Windows only: make sure you set the launch options (see Launch SMAPI through Steam or GOG Galaxy in the Windows install guide), don’t add SMAPI as a non-Steam game.
3. If all else fails, you can use third-party software to add controller support. Suggested software:
   • Linux: SC Controller.
   • Mac: 360Controller. When using a non-Xbox controller, you should enable ‘pretend to be an Xbox 360 controller’. (In some cases, you may need to enable it even for an Xbox controller.)
   • Windows: reWASD (not free after trial period) or InputMapper (free but more complicated) to remap your controller as an Xbox controller.

As a last resort on Linux or Mac, you can disable the SMAPI console window to fix this. You won’t see update/error alerts unless you check the log, and your game won’t launch after a crash until you delete the smapi-internal/StardewModdingAPI.crash.marker file. You should periodically check the log to make sure everything is working correctly. If you really want to do this:

• Linux:
  1. Find your game folder.
  2. Open the StardewValley file (the one with no file extension) in a text editor.
  3. Remove the entire section under # open SMAPI in terminal (up to the next fi line).
  4. Find this text at the bottom:

And change it to this:

And change it to this:

You’ll need to repeat this after updating SMAPI.

After updating to the latest versions, launching the game still shows an old SMAPI or game version

That usually means you have two copies of the game: one copy you updated, and another you’re actually playing.

To check if that’s the issue:

1. Launch the SMAPI installer again, and note the «Game path» shown on the first screen:
   
2. Launch the game with SMAPI, and note the «Mods go here» path shown at the top of the output:
   
3. If the two paths are not identical (except for the /Mods part), then you have two game folders.

If you have multiple copies installed, the best solution is to only have one. To do that:

1. Make a copy of your Mods folder somewhere else.
2. Uninstall the game.
3. Delete both folders you found above.
4. Reinstall the game through Steam or GOG Galaxy.
5. Reinstall SMAPI, which should now detect your single game path.
6. Copy your mods back into the new game folder.

last resort on Linux/Mac

more options
If having multiple copies of the game is deliberate, you can also copy the SMAPI installer into a subfolder of the game folder you want to update. When you run it, it’ll detect the parent folder automatically and update that one.

Fix specific errors

«SMAPI can’t find the game»

• Make sure you’re running StardewModdingAPI.exe in your game folder (see the install instructions).
• Did you install SMAPI manually (not using the installer)? Make sure you copied the right files: internal/Windows for Windows, or internal/Mono for Linux/Mac.

«Skipped ‘. ‘ because it doesn’t have a manifest.json»

SMAPI couldn’t find the manifest.json file for the mod in that folder. That usually means it’s not a SMAPI mod, so it won’t work from the Mods folder. See that mod’s documentation for install instructions.

«missing executable» (Steam only)

Steam can’t find the game launcher, usually because your Steam launch options are incorrect. Common fixes:

• If you want to use SMAPI:
  make sure it’s installed and your launch options are correct (see install guide).
• If you’re uninstalling SMAPI:
  1. In Steam, right-click Stardew Valley and choose Properties.
  2. Click the Set Launch Options button.
  3. Make sure the textbox is completely empty.

«looks like Mono isn’t installed» (Linux/Mac only)

Mono is a framework needed by the installer and SMAPI to work correctly. Installing Mono and restarting your computer usually fixes this error.

On Mac, it might not work after installing Mono. If so:

Enter this command:

Could not load file or assembly

If the ‘file or assembly’ starts with Microsoft or System (like «FileNotFoundException: Could not load file or assembly ‘System.[. ]’ or one of its dependencies«), something is wrong with the core frameworks used by the game.

1. Common fixes:
   
   

   platform	reinstall frameworks
   Windows	reinstall .NET Framework 4.5.2 and XNA Framework 4.0 (those exact versions).
   Linux	reinstall mono-complete.
   Mac	reinstall Mono (either channel is fine).

2. On Windows only, in rare cases that won’t fix the issue. Unfortunately that’s hard to fix since .NET Framework is part of Windows itself. In those cases you may need to perform a Windows reset (you can keep your files), or perform a clean reinstall of Windows. This is drastic, but should fix the issue.

Game freezes when loading a save (Mac only)

On Mac only, the game may freeze when you create or load a save; reinstalling Mono (either version) usually fixes that. If it doesn’t, ask for help!

Game resolution changes when launched with SMAPI (Windows only)

Everything looks bigger/smaller if you launch the game with SMAPI. This is usually due to Windows DPI settings.

1. Right-click on StardewModdingAPI.exe, go to Properties >Compatibility >Change High DPI settings, and keep it open.
2. Right-click on StardewValley.exe, and go to Properties >Compatibility >Change High DPI settings.
3. Change the DPI settings for StardewModdingAPI.exe so they match the ones for StardewValley.exe.

Fix other problems

Run the game without SMAPI by launching Stardew Valley.exe (on Windows) or StardewValley-original (on Linux/Mac) in your game folder.

• If it still happens without SMAPI: see this guide to fixing your game. If you still need help, ask for help.
• If it only happens with SMAPI, ask for help.

Источник

I have googled up and down trying to find a solution, and tried almost every technique for when stardew won’t launch, but nothing has helped

here is what smapi says when it refuses to open, and i don’t know enough about coding to know what to do

[I have tried to reinstall the xna framework thing as it mentions that a bunch but no wheels have been greased apparently]

[SMAPI] SMAPI 3.8.4 with Stardew Valley 1.5.3 on Microsoft Windows 10 Home

[SMAPI] Mods go here: c:program files (x86)steamsteamappscommonStardew ValleyMods

[SMAPI] Starting game…

[SMAPI] Loaded 21 mods:

[SMAPI]    Automate 1.20.0 by Pathoschild | Lets you automate crafting machines, fruit trees, and more by connecting them to chests.

[SMAPI]    AutomaticGates 2.5.1 by Rakiin aKa ScheKaa | Opens and closes gates automatically

[SMAPI]    Bigger Backpack 3.0.0 by spacechase0, yoseiri, bcmpinc | Adds another backpack size.

[SMAPI]    CJB Cheats Menu 1.27.0 by CJBok and Pathoschild | Simple in-game cheats menu!

[SMAPI]    CJB Item Spawner 2.0.2 by CJBok and Pathoschild | Simple in-game item spawner!

[SMAPI]    CJB Show Item Sell Price 1.9.10 by CJBok and Pathoschild | Show item sell price in your inventory!

[SMAPI]    Console Commands 3.8.4 by SMAPI | Adds SMAPI console commands that let you manipulate the game.

[SMAPI]    Fast Animations 1.9.4 by Pathoschild | Speeds up many animations in the game (configurable).

[SMAPI]    Generic Mod Config Menu 1.2.1 by spacechase0 | …

[SMAPI]    Gift Taste Helper 2.9.1 by tstaples (aka catman) | Displays NPC gift tastes in a handy tooltip.

[SMAPI]    Health Bars 1.9.0 by Maurício Gomes (Speeder) | Add health bars to monsters.

[SMAPI]    No Fence Decay 1.5.0 by Cat | Makes all fences and gates last forever.

[SMAPI]    Save Backup 3.8.4 by SMAPI | Automatically backs up all your saves once per day into its folder.

[SMAPI]    Simple Crop Label 5.5.6 by TheMusketeer | Identify crops and trees on farm

[SMAPI]    SkullCavernElevator 1.3.1 by lestoph | Elevator for the Skull Cavern

[SMAPI]    StardewHack 3.0.0 by bcmpinc | Transpilation library used by my other mods. Doesn’t do much on its own.

[SMAPI]    TimeSpeed 2.4.3 by cantorsdust | Lets you control the flow of time in the game: speed it up, slow it down, or freeze it altogether.

[SMAPI]    Tractor Mod 4.13.1 by Pathoschild | Lets you buy a tractor to more efficiently work with crops, clear twigs and rocks, etc.

[SMAPI]    UI Info Suite 2.0.0 by Cdaragorn | Adds a lot of useful information to the user interface. This is based on Demiacle’s excellent UIModSuite.

[SMAPI]    Winter Grass 2.0.3 by Cat | Grass will stay around in winter.

[SMAPI]    Yet Another Jump Mod 0.5.0 by aedenthorn | Advanced Jumping.

[SMAPI] Found 4 mods with warnings:

[SMAPI]    Skipped mods

[SMAPI]    —————————————————

[SMAPI]       These mods could not be added to your game.

[SMAPI]       — Stack Everything 3.0.2 because it’s no longer compatible. Please check for a new version at https://smapi.io/mods

[SMAPI]    Patched game code

[SMAPI]    —————————————————

[SMAPI]       These mods directly change the game code. They’re more likely to cause errors or bugs in-game; if

[SMAPI]       your game has issues, try removing these first. Otherwise you can ignore this warning.

[SMAPI]       — StardewHack

[SMAPI]       — Winter Grass

[SMAPI]       — Yet Another Jump Mod

[StardewHack] Loaded StardewHack library v3.0.0 using Harmony v1.2.0.1.

[Bigger Backpack] Applying bytecode patches for spacechase0.BiggerBackpack.

[UI Info Suite] starting.

[game] The game failed to launch: Microsoft.Xna.Framework.Content.ContentLoadException: Error loading «TileSheetsfurnitureFront». File not found. —> System.IO.FileNotFoundException: Error loading «ContentTileSheetsfurnitureFront.xnb». File not found.

   at Microsoft.Xna.Framework.TitleContainer.OpenStream(String name)

   at Microsoft.Xna.Framework.Content.ContentManager.OpenStream(String assetName)

   — End of inner exception stack trace —

   at Microsoft.Xna.Framework.Content.ContentManager.OpenStream(String assetName)

   at Microsoft.Xna.Framework.Content.ContentManager.ReadAsset[T](String assetName, Action`1 recordDisposableObject)

   at Microsoft.Xna.Framework.Content.ContentManager.Load[T](String assetName)

   at StardewValley.LocalizedContentManager.LoadBase[T](String assetName) in C:GitlabRunnerbuildsGq5qA5P4ConcernedApestardewvalleyFarmerFarmerLocalizedContentManager.cs:line 180

   at StardewModdingAPI.Framework.ContentManagers.BaseContentManager.RawLoad[T](String assetName, Boolean useCache) in C:source_StardewSMAPIsrcSMAPIFrameworkContentManagersBaseContentManager.cs:line 262

   at StardewModdingAPI.Framework.ContentManagers.GameContentManager.RawLoad[T](String assetName, LanguageCode language, Boolean useCache) in C:source_StardewSMAPIsrcSMAPIFrameworkContentManagersGameContentManager.cs:line 238

   at StardewModdingAPI.Framework.ContentManagers.GameContentManager.<>c__DisplayClass10_0`1.<Load>b__0() in C:source_StardewSMAPIsrcSMAPIFrameworkContentManagersGameContentManager.cs:line 106

   at StardewModdingAPI.Framework.Utilities.ContextHash`1.Track[TResult](T key, Func`1 action) in C:source_StardewSMAPIsrcSMAPIFrameworkUtilitiesContextHash.cs:line 53

   at StardewModdingAPI.Framework.ContentManagers.GameContentManager.Load[T](String assetName, LanguageCode language, Boolean useCache) in C:source_StardewSMAPIsrcSMAPIFrameworkContentManagersGameContentManager.cs:line 102

   at StardewModdingAPI.Framework.ContentManagers.BaseContentManager.Load[T](String assetName) in C:source_StardewSMAPIsrcSMAPIFrameworkContentManagersBaseContentManager.cs:line 99

   at StardewValley.Game1.LoadContent() in C:GitlabRunnerbuildsGq5qA5P4ConcernedApestardewvalleyFarmerFarmerGame1.cs:line 2961

   at StardewValley.GameRunner.LoadContent() in C:GitlabRunnerbuildsGq5qA5P4ConcernedApestardewvalleyFarmerFarmerLocalMultiplayer.cs:line 918

   at StardewModdingAPI.Framework.SGameRunner.LoadContent() in C:source_StardewSMAPIsrcSMAPIFrameworkSGameRunner.cs:line 118

   at Microsoft.Xna.Framework.Game.Initialize()

   at StardewValley.GameRunner.Initialize() in C:GitlabRunnerbuildsGq5qA5P4ConcernedApestardewvalleyFarmerFarmerLocalMultiplayer.cs:line 764

   at Microsoft.Xna.Framework.Game.RunGame(Boolean useBlockingRun)

   at Microsoft.Xna.Framework.Game.Run()

   at StardewModdingAPI.Framework.SCore.RunInteractively() in C:source_StardewSMAPIsrcSMAPIFrameworkSCore.cs:line 295

[SMAPI] Game has ended. Press any key to exit.

[SMAPI] You can update 1 mod: