Stardew Valley New Player Guide

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 estimator.
2. Brand certain you have Stardew Valley 1.5.6 or after.
   1. Click the "?" button on the championship screen, and the version will appear in the bottom-left.
   2. Right-click on the game'due south name in Steam and go to Properties. Check the betas tab, and brand sure you are not opted into the 32-bit beta if you are trying to apply SMAPI. For more data, see Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_work_with_compatibility_branch.
3. Reset your content files.
4. If you use SMAPI:
   1. Make certain you have the latest version of that.
      The SMAPI version is shown at the summit 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 aid you diagnose mutual 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 likewise large, or it takes as well long to parse, you tin open information technology up in whatsoever text editor (Notepad or Notepad++ work; on Mac TextEditor works), and so copy from the very top of the log to the bottom of the offset couple errors, and parse that.
   3. The very top of your log will testify a list of all your mods that need to be updated. You tin can also utilize Mod Update Menu to keep rail of your updates from the in-game menu. The beginning thing to try when you're having bug 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 downwards the issue to a specific mod or group of mods, endeavour performing a clean reinstall.
      1. Remove all folders for the modernistic that'south causing the event, making sure to check the modernistic folio for a list of every binder that's included. (If yous're downloading mods from Nexus, you can look under "Preview File Contents." On ModDrop, you can observe that information under "Files" on the sidebar.)
      2. Redownload the mod and follow the installation instructions on the mod folio. If y'all unremarkably utilize a modern manager, reinstall the mod manually to brand sure your issue wasn't acquired past the mod manager placing files in the wrong locations.
5. If you still go the error, look through the common issues on this folio or ask for help!

Reset your content files

Many problems are caused by cleaved game files (especially if you use XNB mods). Yous tin can reset your game files to prepare that. SMAPI mods won't be affected.

1. Meet 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. Choice 2: create retroactive backup to reset any file If you installed XNB mods and want to reset 1 file y'all know is cleaved, you can just restore the original file. If you lot forgot to back information technology up, here's how to recover the original files without losing your modded ones: Copy your game'south Content binder to Content-modded. Reset your game files (see instructions for Steam or for GOG Galaxy). Copy your (now reset) Content folder to Content-backup. Motility Content-modded back to Content. Now your content files are nonetheless modded, but y'all have a fill-in of the original files. Option 3: troubleshoot XNB mods If you installed XNB mods, y'all're not sure which acquired 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. Dorsum up any XNB mods you want to keep. Reset your game files (see instructions for Steam or for GOG Galaxy). Any XNB mods will exist removed, but SMAPI mods won't exist 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 i at a time. Afterwards each install, test the game to brand certain the mod doesn't cause problems.

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

FAQs about Stardew Valley 1.5.five

Do I demand NET 5.0?

Yous shouldn't need Internet five.0 to run Stardew Valley one.5.5+ or SMAPI 3.13.2; Stardew bundles NET v.0.

What are all these weird files in my game binder?

These are from Stardew Valley i.5.5 itself, practise non 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 cleaved, 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, and then follow the links to the unofficial updates. For UI Info Suite, go UI Info Suite 2 from searching smapi.io/mods for the link, and then going to the sidebar on Github for releases. For Content Patcher, make sure you have the well-nigh recent version. For all other mods, check smapi.io/mods for the latest version, which may exist an an unofficial update.

Game doesn't launch

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

one. Try common fixes:

1. Restart your computer.
2. Reset your content files or reinstall the game.
4. Delete your startup_preferences file. (To discover it: open your saves binder, and it'll be in the folder that contains it.)
5. Install the software for your graphics carte du jour (GeForce Feel for NVIDIA or Radeon Software for AMD), and so use that software to update to your latest graphics drivers. (Come across 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 exist found on Windows at %appdata% > Stardew Valley > it's in that binder, or C:\Users\Yourwindowsnamehere\AppData\Roaming\StardewValley or for Mac can exist found at ~/.config/StardewValley
8. If you utilise...

   system	common fixes
   SMAPI on Windows	If you use Steam, double-check that your Steam launch options friction 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 non be uniform. Try installing the xterm terminal.
   SMAPI on macOS	If you use Steam, make sure your Steam launch options are empty.

ii. (Windows only) Run the game on your defended graphics card:

The 'high functioning' option described in the steps on the left.

Many computers take two options for running games: integrated graphics (role of the processor) and dedicated graphics (a separate graphics carte past NVIDIA or AMD). Stardew Valley should exist run on the dedicated graphics, merely that's not always the default (especially on laptops). If you lot're not sure if this applies to your computer, it'south safe to but attempt the instructions below anyway — they but won't exercise anything if it doesn't apply.

To fix this:

1. From the start card, 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 yous play without mods).
3. In the app list, click "Options" under StardewModdingAPI (or Stardew Valley if yous play without mods).
4. Modify the Graphics preference to "Loftier performance".
5. Save.
6. Check whether information technology launches fine now.

3. Check if in that location's an error message:

1. Open up your game binder.
2. Correct-click the folder background. On Windows, too concord Shift
3. Click the option that says Open in Command Prompt, Open up in PowerShell, Open up in Windows Last or Open In Terminal (depending on your system settings/Bone).
4. Type this command:

   if you play...	control
   with mods on Windows	.\StardewModdingAPI.exe
   without mods on Windows	.\"Stardew Valley.exe"
   with mods on Mac/Linux	./StardewModdingAPI
   without mods on Mac/Linux	./"Stardew Valley"

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

(annotation: whatsoever control prompt works, including WSL'south, if you don't like powershell/command prompt.)

four. Enquire for assistance:

If you lot still oasis't solved information technology, come Ask for help!

Specific mistake messages

"Could not load 'Stardew Valley' or 1 of its dependencies"

SMAPI wasn't able to load the game'due south executable. At that place's a number of possible reasons for this:

1. Reset your content files.
2. Make certain y'all accept Stardew Valley 1.5.6 or subsequently. (If you lot're not sure: launch without mods per stride 4 beneath, click the "?" button on the title screen, and check the bottom-left corner of the screen.)
3. Brand sure y'all have the latest version of SMAPI.
4. Make sure y'all can launch the game without SMAPI:
   1. Open your game binder.
   2. Double-click  Stardew Valley.exe (on Windows) or StardewValley-original (on Linux/macOS).
   3. If the game doesn't piece of work either, come across game doesn't launch.
5. Make certain you didn't enable the "compatibility co-operative" in Steam or GOG Galaxy (mods don't work on the compatibility branch).
6. Make certain 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 past the underlying game framework.

Common fixes:

one. Update your graphics drivers:

1. Install the app for your graphics card (GeForce Feel for NVIDIA or Radeon Software for AMD). If you're not sure, meet how to check which graphics menu you take.
2. Open the app.
3. Observe the section that shows graphics driver info. Make sure it says you take the latest version, and install whatsoever updates if not.

two. (Windows only) Run the game on your dedicated graphics bill of fare:

The 'loftier performance' choice 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 split up graphics card by NVIDIA or AMD). Stardew Valley should be run on the dedicated graphics, only that's not ever the default (particularly on laptops). If you're non sure if this applies to your computer, it'southward safe to merely try the instructions below anyway — they just won't do anything if information technology doesn't apply.

To fix this:

1. From the start menu, search for Graphics Settings and open information technology.
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 y'all play without mods).
4. Modify the Graphics preference to "High operation".
5. Save.
6. Check whether it launches fine now.

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

As an accented final resort, you can...

• Employ the Stardew Valley compatibility branch (note that that mods don't work with that version currently);
• or downgrade to Stardew Valley one.v.4 or earlier (notation that you lot'll need to employ older versions of SMAPI and many mods).

"Skipped '...' considering it doesn't have a manifest.json"

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

"missing executable" (Steam only)

Steam can't notice the game launcher, usually considering your Steam launch options are incorrect. Common fixes:

• If you want to use SMAPI:
  make sure it'southward installed and your launch options are correct (run across install guide).
• If you're uninstalling SMAPI:
  
  1. In Steam, right-click Stardew Valley and choose Backdrop.
  2. Click the Prepare 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 'Organization.[...]' or one of its dependencies") OR yous go something similar "The library '[...].dll' required to execute the application is non found in 'C:\Programme 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 so reinstall it.
• Bank check to make certain you don't accidentally accept 2 copies of the game.

(Stardew at present comes packaged with the dependencies needed to run, then yous shouldn't need to install them yourself.)

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

OutOfMemoryException errors (Windows only)

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 mutual fixes:

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

SMAPI takes forever to load! (Select Fashion)

Brand sure y'all're not in Select Style (noted by the discussion "Select" tiptop left corner of the SMAPI Window.) This mode pauses loading and then you can come across what the panel says, and y'all can enter information technology by selecting any text on the SMAPI panel.

**To Fix**: Just click on the console and striking enter a few times to go out of it.

The Select mode indicator

NoAudioHardwareException: Audio has failed to initialize

This exception ways that for whatever reason, either the game or SMAPI cannot employ your calculator'due south audio. A possible fix (for Windows) is installing OpenAl.

Other issues

Game lags or stutters in-game

There'due south a few things yous can try.

1. If y'all 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 in that location are, see get aid).
   3. Temporarily remove all mods except SMAPI and Error Handler. If that fixes information technology, 1 of your mods might be causing lag. (Yous tin even so try the other fixes below to come across if they help.)
2. For Windows players just, run the game on your defended graphics card (run across subsection 2).
3. Add an exception in your antivirus software for the Stardew Valley folder. You tin search online for your antivirus proper 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. Endeavour excluding the game folder in that example.
4. Set the processor affinity for  StardewModdingAPI.exe (if using mods) or  Stardew Valley.exe (without mods) to ii or higher.
5. Set the process priority for  StardewModdingAPI.exe (if using mods) or  Stardew Valley.exe (without mods) to Loftier.
6. If you own the Steam version of the game, endeavor launching the game through the Steam customer.

If y'all're still having issues after that, come across get help.

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

Audio plays fine in your browser or other apps, simply the game is silent. Hither are some mutual fixes:

1. Restart your calculator.
2. Brand sure the Windows mixer isn't muting the game.
3. Make sure the in-game audio slider options aren't muted.
4. Check the debugging options under "Game doesn't launch".
5. Check for a NoAudioHardwareException and follow instructions at that place

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. Common fix:
   1. Open your game binder.
   2. Correct-click the  StardewModdingAPI.exe file, go to Properties > Compatibility > Change High DPI settings, and continue it open.
   3. Right-click the  Stardew Valley.exe file, and become to Properties > Compatibility > Change High DPI settings.
   4. Change the DPI settings for  StardewModdingAPI.exe so they match the ones for  Stardew Valley.exe .
2. Alternative fix:
   1. Same as to a higher place, but check "Override high DPI scaling behavior" and select "Application" for both.

Troubleshooting:

• If y'all installed SMAPI using Vortex, you lot might not see the Compatibility section. In that case install SMAPI using its installer instead (you tin still apply Vortex to manage mods later doing that).

Relieve disappeared or doesn't load

Encounter Saves#Troubleshooting.

Can't connect to some other player in multiplayer

1. Check that Stardew Valley is upward to appointment and your save is loaded in co-op mode. The host needs to go to the Co-op tab in the primary carte and launch the save past clicking "Host (farmname) Farm". Loading a salve through the regular load game menu, fifty-fifty if cabins have been built, volition launch it in singleplayer.
2. Make sure you have enough cabins congenital for the number of players.
3. Make sure everyone launches the game through Steam or GOG Galaxy (non a carve up shortcut). On Windows, encounter Configure your game customer in the Windows install guide.
4. Brand certain 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'southward very likely the crusade. Never use more than than one antivirus at a time.
6. Exercise 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 cheque for any updates for your router.
10. If you don't see the 'enter invite code' option, your Steam proper noun may have been flagged every bit inappropriate. Effort irresolute it and re-launching the game.
11. (Windows only) Check debugging steps under Game Doesn't Launch.
12. If you apply 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.one and check whether the protocol version matches.

For console players, delight endeavour as many of the steps every bit yous can (particularly the first three) and try power cycling your console. Delight note that all consoles require their paid online service to play over the cyberspace.

SMAPI files disappear or antivirus complains

Your antivirus might remove or report SMAPI/modern files. This is almost ever a false positive, pregnant the files don't incorporate a trojan.

How can I know if it'south actually safe?

Nothing on the Internet is guaranteed, but SMAPI itself is almost likely safe — you tin check by reading the code, decompiling the download, or uploading information technology to VirusTotal. (VirusTotal scans the file with threescore or so antiviruses; if only one or two detect an event, it's nearly likely a false positive.)

For mods, you can cheque past decompiling them or uploading to VirusTotal also. Note that every file downloaded from Nexus Mods is scanned before it'due south available.

Why does this happen?

Antiviruses are normally concerned considering...

• The download is withal new. In this case it didn't really detect anything, it's merely worried because it's an unknown file. Antiviruses ofttimes evidence a fake trojan proper name like Trojan:Win32/Emali.A!cl for this. Antiviruses learn to allow it later plenty users download it, just that resets for each release.
• Antiviruses may check for certain patterns similar accessing files or rewriting code, which are both things SMAPI mods do every bit office of their normal functionality (since changing the game is the whole point).

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

• One selection is to just wait a few days before downloading a new update (or a few weeks for a less pop mod). By then enough users should have downloaded information technology to reduce antivirus alerts.
• If you lot've checked that it'south safe above, another pick 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 binder (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 certain 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 together controller support. Suggested software:
   • Linux: SC Controller.
   • Mac: 360Controller. When using a non-Xbox controller, you lot should enable 'pretend to exist an Xbox 360 controller'. (In some cases, yous may need to enable information technology even for an Xbox controller.)
   • Windows: reWASD (not free afterwards trial period) or InputMapper (free but more complicated) to remap your controller equally an Xbox controller.

last resort on Linux/Mac

As a last resort on Linux or Mac, y'all can disable the SMAPI console window to gear up this. You won't run across update/error alerts unless you cheque the log, and your game won't launch afterwards a crash until y'all delete the smapi-internal/StardewModdingAPI.crash.marking file. You lot should periodically check the log to brand sure everything is working correctly. If y'all really desire to practise this: On Linux or macOS: Detect your game folder. Open the StardewValley file (the one with no file extension) in a text editor. Change SKIP_TERMINAL=false nearly the top to SKIP_TERMINAL=true. On Windows: disabling the panel window isn't possible. You lot'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 ane spot and snaps dorsum whenever yous effort to movement it.

That happens when the game doesn't detect the gamepad mode correctly. To set up it:

1. Load your save.
2. Open up the in-game menu and become to the options.
3. Set the Gamepad Mode option to either Force On (if y'all utilise a controller) or Forcefulness Off (if you utilize a keyboard and mouse).

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

That usually means yous take ii copies of the game: i copy you updated, and another you're actually playing.

To check if that's the upshot:

1. Launch the SMAPI installer again, and notation 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 y'all have 2 game folders.

If you accept multiple copies installed, the best solution is to only accept 1. To practice that:

1. Make a copy of your Mods folder somewhere else.
2. Uninstall the game.
3. Delete both folders you found to a higher place.
4. Reinstall the game through Steam or GOG Milky way.
5. Reinstall SMAPI, which should at present detect your single game path.
6. Copy your mods back into the new game binder.

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 lot want to update. When y'all run it, it'll discover the parent folder automatically and update that ane.

SMAPI installer opens, and then immediately closes

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

A: Make sure yous're installing SMAPI 3.13.ane or after, 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 endeavor these steps:

1. Open the installer binder.
2. Hold shift and correct-click on the folder background.
3. Click the option that says Open up 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 Last).
5. At present if it crashes, the window should stay open then you lot can run across the error.
6. Mail a screenshot of the full window when information technology shows the error in the #using-mods discord channel for debugging help.

2 copies of saves

Try uninstalling Become Glam if you take it installed.

Known issues

SMAPI doesn't work with the compatibility branch

What is the compatibility branch?

There'south two versions of Stardew Valley 1.five.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 employ different frameworks.

Why don't mods work with information technology?

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

Having multiple versions of SMAPI (like we do for Linux/macOS/Windows compatibility) wouldn't exist enough in this case. Every C# modernistic writer would need to manually port two versions of every update of every modern forever, which is prohibitively unfeasible. It's possible that in the futurity we'll either effigy out how SMAPI tin automatically rewrite mods for the compatibility branch, or some modders may port SMAPI and individual mods to the compatibility co-operative.

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

Y'all have a few options.

1. First, make sure y'all really tin't update. Over 99% of systems should be compatible with the chief branch; information technology's only very old system that are 32-fleck-only or utilize unsupported graphics cards that might not piece of work.
2. Or y'all can switch to the game's compatibility branch without mods. Mods don't work with information technology currently, but it'll go along 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 yous tin keep playing like before. The newest mod updates won't piece of work for you, but you lot'll exist able to install any modern 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 lot'd be able to switch to the compatibility branch instead.

   If yous want to rollback to Stardew Valley 1.5.iv, here's how:

   1. Install .Net 5 or after.
   2. Download the latest DepotDownloader release.
   3. Open up a control prompt in the DepotDownloader folder.
   4. Run this command (supplant <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 motility your mods over.
   6. Launch StardewModdingAPI.exe in the downloaded binder.

Get assist

Report a bug

If you play without mods

See this guide to fixing your game. If yous still demand assistance, ask for help.

If you play with mods

Starting time, bank check whether it happens without mods also:

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

If information technology merely happens with mods installed, ask for help. Otherwise encounter If you lot play without mods above.

Enquire for help

Come across Modding:Help for how to get assist!

Stardew Valley New Player Guide,

Source: https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting

Posted by: wallaceclet1940.blogspot.com

Share this post