Modding:Player Guide/Troubleshooting - Stardew Valley Wiki (2024)

Modding:Index

Player's guide to using mods

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

Contents

  • 1 The basics
    • 1.1 Common fixes
    • 1.2 Reset your content files
    • 1.3 Run the game on your dedicated graphics card (Windows only)
    • 1.4 FAQs about Stardew Valley 1.6
  • 2 Game doesn't launch
  • 3 Specific error messages
    • 3.1 "Could not load 'Stardew Valley' or one of its dependencies"
    • 3.2 "The game failed to launch: Microsoft.Xna.Framework.Graphics.NoSuitableGraphicsDeviceException: Failed to create graphics device"
    • 3.3 "Skipped '...' because it doesn't have a manifest.json"
    • 3.4 "missing executable" (Steam only)
    • 3.5 "Could not load file or assembly"
    • 3.6 OutOfMemoryException errors
    • 3.7 SMAPI takes forever to load!
    • 3.8 NoAudioHardwareException: Audio has failed to initialize
    • 3.9 Mac: Contents/MacOS/StardewValley Already Exists
  • 4 Other issues
    • 4.1 Game lags or stutters in-game
    • 4.2 Game audio doesn't play or audio is distorted (Windows only)
    • 4.3 Game resolution changes when launched with SMAPI (Windows only)
    • 4.4 Save disappeared or doesn't load
    • 4.5 Can't connect to another player in multiplayer
    • 4.6 SMAPI or mod files disappear, or they're blocked by your antivirus or browser
    • 4.7 SMAPI doesn't recognize controller (Steam only)
    • 4.8 Cursor gets stuck on museum or build screen
    • 4.9 After updating to the latest versions, launching the game still shows an old SMAPI or game version
    • 4.10 SMAPI installer opens, then immediately closes
    • 4.11 Two copies of saves
    • 4.12 Pet event repeating over and over
    • 4.13 Game screen is frozen when launched via SteamLink or other Steam RemotePlay
  • 5 Known issues
    • 5.1 SMAPI doesn't work with the compatibility branch
  • 6 Get help
    • 6.1 Report a bug
    • 6.2 Ask for help

Common fixes

  1. Restart your computer.
  2. Make sure you have Stardew Valley 1.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 the instructions for your platform:
  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:
  1. Copy your game's Content folder to Content-modded.
  2. Reset your game files (see instructions for Steam, for GOG Galaxy, or for Xbox).
  3. Copy your (now reset) Content folder to Content-backup.
  4. 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.
  1. Back up any XNB mods you want to keep.
  2. Reset your game files (see instructions for Steam, for GOG Galaxy, or for Xbox). Any XNB mods will be removed, but SMAPI mods won't be affected.
  3. If you use SMAPI on Linux or macOS, reinstall SMAPI to fix the launcher.
  4. Launch the game to see if the problem is fixed.
  5. 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.

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

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 your issues still happen.

FAQs about Stardew Valley 1.6

Are mods updated for 1.6?
Stardew Valley 1.6 is a major update, so many mods will need to be updated for it.
  • The latest SMAPI and Content Patcher add full support for Stardew Valley 1.6. Make sure you update SMAPI and all your mods to the latest versions.
  • 44% of SMAPI mods were ready on day one, and that number should steadily rise as they get updated. You can check the mod compatibility list to see if your mods are updated, or look for purple update alerts in your SMAPI console window.
  • Most content packs should work fine once the SMAPI mod which loads them is updated.
  • XNB mods are mostly broken in 1.6. These have been deprecated for years and may cause issues like broken textures, missing or broken game content, and crashes. You can reset your game files to remove any you have.
What does 1.6 change for mods?
Stardew Valley 1.6 has a huge number of changes to help mod authors. For players, it has a lot of player changes and will also let mods do much more in the future.
Can I go back to Stardew Valley 1.5.6 until my mods update?
Yep. If you use Steam:
  1. Click Stardew Valley in the Steam client.
  2. Hit the cog button in the top-right corner and click the Properties option.
  3. Go to the Betas tab.
  4. Select "legacy_1.5.6" in the Beta Participation dropdown.
If you use GOG:
  1. Launch GOG Galaxy.
  2. Click Stardew Valley.
  3. From the menu at the top, click Extras to see downloads for previous versions.

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.
  3. Delete your startup_preferences file. (To find it: open your saves folder, and it'll be in the folder that contains it.)
  4. Install the software for your graphics card (GeForce Experience for NVIDIA or AMD Software for AMD), then use that software to update to your latest graphics drivers. (See how to check which graphics card you have.)
  5. Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).
  6. If you use...
    systemcommon fixes
    SMAPI on WindowsIf 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 macOSIf you use Steam, make sure your Steam launch options are empty.
2. (Windows only) Run the game on your dedicated graphics card:
See Run the game on your dedicated graphics card (Windows only) above. Don't skip this step! It very often fixes the issue.
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!

"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.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 AMD 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:
See Run the game on your dedicated graphics card (Windows only) above. Don't skip this step! It very often fixes the issue.
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 Files\dotnet`" (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.

This might also show up as Unable to allocate pixels for the bitmap.

Some common fixes:

  • Make sure you have the latest Stardew Valley 1.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 Run the game on your dedicated graphics card (Windows only) above 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.

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:
    1. Run the game on your dedicated graphics card.
    2. Install the software for your graphics card (GeForce Experience for NVIDIA or AMD Software for AMD), then use that software to update to your latest graphics drivers. (See how to check which graphics card you have.)
    3. If using NVIDIA GeForce Experience, make sure WhisperMode is disabled.
  3. For Linux/SteamDeck players:
    1. From your game folder, open smapi-internal/config.json and set ListenForConsoleInput to false. (Note the instructions at the top of that file about creating a config.user.json file.)
  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.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.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 or mod files disappear, or they're blocked by your antivirus or browser

Your antivirus or browser might delete, block, or report SMAPI or 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 it's most likely safe — you can check by reading the code (e.g. see SMAPI's 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. Note that all files on Nexus Mods are scanned by VirusTotal automatically before they're available to download.
Why does this happen?
Antiviruses and browsers 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 download a file which my browser blocks as 'suspicious'?
There are two approaches:
  • You can wait a few days before downloading a new update (or a few weeks for a less popular mod). Once enough users have downloaded it, your browser won't considers it an unknown file anymore.
  • Or the browser UI which says the file is supicious should have a 'more info' link, or a symbol like or which indicates options. Click that to show the option to download it anyway.
How can I install SMAPI or a mod if my antivirus flags it?
There are two approaches:
  • You can wait 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.
  • Or 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).
  3. If all else fails, you can use third-party software to add controller support. Suggested software:
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:
    1. Find your game folder.
    2. Open the StardewValley file (the one with no file extension) in a text editor.
    3. 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.

Game screen is frozen when launched via SteamLink or other Steam RemotePlay

solution - from PC
  1. Launch SDV via SMAPI's StardewModdingAPI
  2. The cmd will open and show logging information about loading... and then it will launch SDV
  3. Once SDV is launched you need to [alt]+[tab] out of it. It should go to cmd once you do, but if it doesn't immediately select cmd, simple select that window
  4. Click the minimize button [-] on cmd to minimize it
  5. With cmd now minimized, you can refocus SDV by clicking the window and it should now be unfrozen!
solution - from controller connected to SteamLink
  1. Launch SDV via SMAPI's StardewModdingAPI
  2. The cmd will open and show logging information about loading... and then it will launch SDV
  3. Once SDV is launched, the screen will appear frozen. Hold down the left "options-like" button on your controller to open the SteamLink quick menu.
    • On an Xbox controller, this is the "Back" button
    • On a PlayStation controller, this is the "Share" button
    • On a Steam controller, this is the "Left Arrow" button
  4. In this menu, select the "Virtual Keyboard" option to reveal an onscreen keyboard
  5. Select the `[alt]` key and then the `[tab]` key. This will Alt-Tab you out of the frozen SDV screen and auto-focus the cmd window.
  6. With the cmd now revealed and focused, on the still visible "Virtual Keyboard" select the "Windows" key and then the "down arrow" key. This should minimize the cmd window
    • The "Windows" key is in the bottom-left side of the keyboard and looks like it has 4 arrows/triangle icons on it.
  7. When cmd minimizes SDV should automatically be refocused and should now be unfrozen!

SMAPI doesn't work with the compatibility branch

What is the compatibility branch?
There's two versions of Stardew Valley 1.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 (depots\413151\8043676)and move your mods over.
    6. Launch StardewModdingAPI.exe in the downloaded folder.

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!

Getting Started

Compatibility

Modding:Player Guide/Troubleshooting - Stardew Valley Wiki (2024)
Top Articles
Latest Posts
Recommended Articles
Article information

Author: Saturnina Altenwerth DVM

Last Updated:

Views: 6244

Rating: 4.3 / 5 (44 voted)

Reviews: 83% of readers found this page helpful

Author information

Name: Saturnina Altenwerth DVM

Birthday: 1992-08-21

Address: Apt. 237 662 Haag Mills, East Verenaport, MO 57071-5493

Phone: +331850833384

Job: District Real-Estate Architect

Hobby: Skateboarding, Taxidermy, Air sports, Painting, Knife making, Letterboxing, Inline skating

Introduction: My name is Saturnina Altenwerth DVM, I am a witty, perfect, combative, beautiful, determined, fancy, determined person who loves writing and wants to share my knowledge and understanding with you.