We are in the process of transferring the hosting and maintenance responsibilities of the wiki from Chucklefish to ConcernedApe, which is why the wiki will temporarily be hosted at stardewcommunitywiki.com. Soon the official wiki will resume at stardewvalleywiki.com and will be hosted going forward by ConcernedApe. Prior to the transfer to ConcernedApe we will update this site with the date on which the transfer will occur.
Did something go wrong with your game? This is the page for you. (This page isn't only for players who use mods!)
- 1 Common fixes
- 2 Fix common problems
- 2.1 Game doesn't launch
- 2.2 Game freezes or crashes while opening
- 2.3 Game audio doesn't play (Windows only)
- 2.4 Save disappeared or doesn't load
- 2.5 Can't connect to another player in multiplayer
- 2.6 SMAPI files disappear or antivirus complains
- 2.7 SMAPI doesn't recognize controller (Steam only)
- 2.8 After updating to the latest versions, launching the game still shows an old SMAPI or game version
- 3 Fix specific errors
- 3.1 "SMAPI can't find the game"
- 3.2 "Skipped '...' because it doesn't have a manifest.json"
- 3.3 "missing executable" (Steam only)
- 3.4 "looks like Mono isn't installed" (Linux/Mac only)
- 3.5 Could not load file or assembly
- 3.6 Game freezes when loading a save (Mac only)
- 3.7 Game resolution changes when launched with SMAPI (Windows only)
- 4 Fix other problems
- 5 Ask for help
- Restart your computer.
- Make sure you have Stardew Valley 1.5.2 or later.
Click the "?" button on the title screen, and the version will appear in the bottom-left.
- Reset your content files.
- If you use SMAPI:
- Make sure you have the latest version of that.
The SMAPI version is shown at the top of the SMAPI console window.
- 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.
- 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.
- If you've narrowed down the issue to a specific mod or group of mods, try performing a clean reinstall.
- 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.)
- 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.
- Make sure you have the latest version of that.
- 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.
- See instructions for Steam or for GOG Galaxy.
- If you use SMAPI on Linux/Mac, reinstall SMAPI to fix the launcher.
| If you don't want to reset all files, you have some other options.
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:
- Restart your computer.
- Make sure you have speakers or headphones plugged in. (They can be muted, but the game needs a working audio device.)
- If you play on Windows:
- If you play on Linux:
- Your default terminal might not be compatible. Try installing the xterm terminal.
- If that doesn't fix it:
Game freezes or crashes while opening
The game tries to open, but crashes before the title screen. Here are some common fixes:
- Try everything in the list above first.
- Delete your
startup_preferences, found in
- Disable antivirus if using SMAPI.
- Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).
- 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:
- Restart your computer.
- Make sure the Windows mixer isn't muting the game.
- Make sure the in-game sound slider options aren't muted.
- Reinstall .NET Framework 4.5.2 and XNA Framework 4.0.
Save disappeared or doesn't load
Can't connect to another player in multiplayer
- Check that Stardew Valley is up to date and your save is loaded in co-op mode.
- Make sure you have enough cabins built for the number of players.
- Make sure everyone launches the game through Steam or GOG Galaxy (not a separate shortcut).
- Make sure the server is set to online in the game options.
- 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.
- Do a content reset for all players.
- Delete your
%appdata%/StardewValleyon Windows or
- 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: 22.214.171.124and 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.
- 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...
SMAPI doesn't recognize controller (Steam only)
- Launch the game through Steam.
- 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.
- 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:
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:
- Launch the SMAPI installer again, and note the "Game path" shown on the first screen:
- Launch the game with SMAPI, and note the "Mods go here" path shown at the top of the output:
- If the two paths are not identical (except for the
/Modspart), then you have two game folders.
If you have multiple copies installed, the best solution is to only have one. To do that:
- Make a copy of your Mods folder somewhere else.
- Uninstall the game.
- Delete both folders you found above.
- Reinstall the game through Steam or GOG Galaxy.
- Reinstall SMAPI, which should now detect your single game path.
- Copy your mods back into the new game folder.
|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.exein your game folder (see the install instructions).
- Did you install SMAPI manually (not using the installer)? Make sure you copied the right files:
internal/Windowsfor Windows, or
"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:
- In Steam, right-click Stardew Valley and choose Properties.
- Click the Set Launch Options button.
- 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-libgdiplusin 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.
- 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).
- 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)
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.
- Right-click on StardewModdingAPI.exe, go to Properties > Compatibility > Change High DPI settings, and keep it open.
- Right-click on StardewValley.exe, and go to Properties > Compatibility > Change High DPI settings.
- 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!