105,785
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + − <h1 style="border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em; margin-bottom:0;">The basics</h1>+ − − + − + Line 24:
Line 23: − + − + + + + Line 32:
Line 34: − + Line 40:
Line 42: − + − + − + + + + + + + + + + + + + + + − + − + − + − ; What are all these weird files in my game folder?+ − + + + − + − + − <h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;">Game doesn't launch</h1>+ + + + + + + + + + + + + Line 67:
Line 97: − + Line 90:
Line 120: − + − − 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: − − # From the start menu, search for ''Graphics Settings'' and open it. − # In the window that opens, click "Browse" near the top and choose {{executable name|StardewModdingAPI}} in [[Modding:Player Guide/Getting Started#Find your game folder|your game folder]] (or {{executable name|Stardew Valley}} if you play without mods). − # In the app list, click "Options" under <samp>StardewModdingAPI</samp> (or <samp>Stardew Valley</samp> if you play without mods). − # Change the Graphics preference to "High performance". − # Save. − # Check whether it launches fine now. − Line 137:
Line 155: − <h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;">Specific error messages</h1>+ − Line 162:
Line 179: − + Line 168:
Line 185: − + − − 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: − − # From the start menu, search for ''Graphics Settings'' and open it. − # In the window that opens, click "Browse" near the top and choose {{executable name|StardewModdingAPI}} in [[Modding:Player Guide/Getting Started#Find your game folder|your game folder]] (or {{executable name|Stardew Valley}} if you play without mods). − # In the app list, click "Options" under <samp>StardewModdingAPI</samp> (or <samp>Stardew Valley</samp> if you play without mods). − # Change the Graphics preference to "High performance". − # Save. − # Check whether it launches fine now. − Line 213:
Line 218: − + + + − + − − ==SMAPI takes forever to load! (Select Mode)== − − Make sure you're not in Select Mode (noted by the word "Select" top left corner of the SMAPI Window.) This mode pauses loading so you can see what the console says, and you can enter it by selecting any text on the SMAPI console. − − <nowiki>**</nowiki>To Fix**: Just click on the console and hit enter a few times to get out of it. − − [[File:Screenshot 2022-01-08 140059.png|600px|thumb|left|The Select mode indicator]]{{Clear}} − − ==SMAPI takes forever to load! (Not in select mode)== + + − + + − + + + + + + + + − <h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;min-width: 100% !important;">Other issues</h1>+ + Line 249:
Line 257: − + + + + + + Line 266:
Line 279: − + + + + + Line 278:
Line 295: + Line 283:
Line 301: − + − + − + − # Make sure the server is set to online in the game options.+ − + − # [[#Reset your content files|Do a content reset for all players]].+ − # Delete your <code>startup_preferences</code> (found in <code>%appdata%/StardewValley</code> on Windows or <code>~/.config/StardewValley</code> on Linux/Mac).+ + + − + − + − + − + − + − + − − :: For mods, you can check by [https://www.jetbrains.com/decompiler/ decompiling them] or [https://www.virustotal.com/ uploading to VirusTotal] too. Note that every file downloaded from Nexus Mods is scanned before it's available. − + − + + + + − + − + + + Line 322:
Line 345: − + Line 383:
Line 406: − + − − <h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;">Known issues</h1> + Line 399:
Line 421: − + Line 405:
Line 427: + + Line 414:
Line 438: − + + + + Line 423:
Line 450: − <h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;">Get help</h1>+ − Line 443:
Line 469: + +
no edit summary
{{../header}}
{{modding player guide header}}
Did something go wrong with your game? This is the page for you. (This page isn't only for players who use mods!)
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==
==Common fixes==
# Restart your computer.
# Restart your computer.
# Make sure you have Stardew Valley {{version|link=0}} or later.
# Make sure you have Stardew Valley {{version|link=0}} or later.
## Click the "?" button on the title screen, and the version will appear in the bottom-left.
## Click the "?" button on the title screen, and the version will appear in the bottom-left.
## Right-click on the game's name in Steam and go to Properties. Check the betas tab, and make sure you are <strong>not opted into the 32-bit beta</strong> if you are trying to use SMAPI. For more information, see [[Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_work_with_compatibility_branch]].
## Right-click on the game's name in Steam and go to Properties. Check the betas tab, and make sure you are <strong>not opted into the 32-bit beta</strong> if you are trying to use SMAPI. For more information, see [[Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_work_with_the_compatibility_branch]].
# [[#reset-content|Reset your content files]].
# [[#reset-content|Reset your content files]].
# If you use SMAPI:
# If you use SMAPI:
## Make sure you have the [https://smapi.io/ latest version of that].<br /><small>The SMAPI version is shown at the top of the SMAPI console window.</small>
## Make sure you have the [https://smapi.io/ latest version of that].<br /><small>The SMAPI version is shown at the top of the SMAPI console window.</small>
## Upload a log to [https://smapi.io/log 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 [https://stardewmodding.miraheze.org/wiki/Tutorial:_How_to_read_your_SMAPI_log annotated log] for more information on how to read and understand your log.
## Upload a log to [https://smapi.io/log 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 [https://stardewmodding.wiki.gg/wiki/Tutorial:_How_to_read_your_SMAPI_log annotated log] for more information on how to read and understand your log.
### 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.
### 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.
## The very top of your log will show a list of all your mods that need to be updated. You can also use {{nexus mod|2536|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.'''
## The very top of your log will show a list of all your mods that need to be updated. You can also use {{nexus mod|2536|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.'''
Many problems are caused by broken game files (especially if you [[Modding:Using XNB mods|use XNB mods]]). You can reset your game files to fix that. SMAPI mods won't be affected.
Many problems are caused by broken game files (especially if you [[Modding:Using XNB mods|use XNB mods]]). You can reset your game files to fix that. SMAPI mods won't be affected.
# See instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam] or [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy].
# See the instructions for your platform:
# If you use SMAPI on Linux/Mac, reinstall SMAPI to fix the launcher.
#* [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam];
#* [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy];
#* [https://support.xbox.com/en-US/help/games-apps/troubleshooting/troubleshoot-games-windows-10 for Xbox App for PC / PC Game Pass] (under ''Problems launching a game from the Xbox app'' and then ''Repair the game'').
# If you use SMAPI on Linux or macOS, reinstall SMAPI to fix the launcher.
{{collapse|more options|css=border: 1px solid #666; margin-top: 1em; padding: 0.2em;|content=If you don't want to reset ''all'' files, you have some other options.
{{collapse|more options|css=border: 1px solid #666; margin-top: 1em; padding: 0.2em;|content=If you don't want to reset ''all'' files, you have some other options.
: 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:
: 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 <code>Content</code> folder to <code>Content-modded</code>.
:# Copy your game's <code>Content</code> folder to <code>Content-modded</code>.
:# Reset your game files (see instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam] or [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy]).
:# Reset your game files (see instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam], [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy], or [https://support.xbox.com/en-US/help/games-apps/troubleshooting/troubleshoot-games-windows-10 for Xbox]).
:# Copy your (now reset) <code>Content</code> folder to <code>Content-backup</code>.
:# Copy your (now reset) <code>Content</code> folder to <code>Content-backup</code>.
:# Move <code>Content-modded</code> back to <code>Content</code>.
:# Move <code>Content-modded</code> back to <code>Content</code>.
: 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.
: 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.
:# Back up any XNB mods you want to keep.
:# Reset your game files (see instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam] or [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy]). Any XNB mods will be removed, but SMAPI mods won't be affected.
:# Reset your game files (see instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam], [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy], or [https://support.xbox.com/en-US/help/games-apps/troubleshooting/troubleshoot-games-windows-10 for Xbox]). 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.
:# If you use SMAPI on Linux or macOS, reinstall SMAPI to fix the launcher.
:# Launch the game to see if the problem is fixed.
:# 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.
:# Reinstall your XNB mods one at a time. After each install, test the game to make sure the mod doesn't cause problems.
}}
}}
<div style="border: 1px solid red; background: #FCC; padding: 1em;">'''Caution:''' XNB mods (which replace your game files directly) are [[Modding:Using XNB mods|no longer recommended]] and can cause issues. Resetting your content files will remove XNB mods you installed. After doing so, consider [[Modding:Using XNB mods#Alternatives using Content Patcher|using content packs instead]].'''</div>
<div class="modding-error-box">'''Caution:''' XNB mods (which replace your game files directly) are [[Modding:Using XNB mods|no longer recommended]] and can cause issues. Resetting your content files will remove XNB mods you installed. After doing so, consider [[Modding:Using XNB mods#Alternatives using Content Patcher|using content packs instead]].'''</div>
==<span id="dedicated-gpu">Run the game on your dedicated graphics card (Windows only)</span>==
[[File:SMAPI dedicated GPU on Windows.png|thumbnail|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:
# From the start menu, search for ''Graphics Settings'' and open it.
# In the window that opens, click "Browse" near the top and choose {{executable name|StardewModdingAPI}} in [[Modding:Player Guide/Getting Started#Find your game folder|your game folder]] (or {{executable name|Stardew Valley}} if you play without mods).
# In the app list, click "Options" under <samp>StardewModdingAPI</samp> (or <samp>Stardew Valley</samp> if you play without mods).
# Change the Graphics preference to "High performance".
# Save.
# Check whether your issues still happen.
==FAQs about Stardew Valley 1.5.5==
==FAQs about Stardew Valley 1.6==
; Do I need NET 5.0?
; Are mods updated for 1.6?
: You shouldn't need NET 5.0 to run Stardew Valley 1.5.5+ or SMAPI 3.13.2; Stardew bundles NET 5.0.
: Stardew Valley 1.6 is a major update, so many mods will need to be updated for it.
:* The latest [https://smapi.io/ SMAPI] and [https://www.nexusmods.com/stardewvalley/mods/1915 Content Patcher] add full support for Stardew Valley 1.6. Make sure you update SMAPI and all your mods to the latest versions.
: These are from Stardew Valley 1.5.5 itself, do not delete them! (Stardew now bundles dependencies, that's what all those files are!)
:* 44% of SMAPI mods were ready on day one, and that number should steadily rise as they get updated. You can check the [https://smapi.io/mods/ 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.
:* [[Modding:Using XNB mods|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 content files|reset your game files]] to remove any you have.
; Are mods updated for 1.5.5?
; What does 1.6 change for mods?
: 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.
: Stardew Valley 1.6 has [[Modding:Migrate to Stardew Valley 1.6|a huge number of changes to help mod authors]]. For players, it has {{version|1.6|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:
:# Click ''Stardew Valley'' in the Steam client.
:# Hit the cog button in the top-right corner and click the ''Properties'' option.
:# Go to the ''Betas'' tab.
:# Select "legacy_1.5.6" in the Beta Participation dropdown.
: If you use GOG:
:# Launch GOG Galaxy.
:# Click Stardew Valley.
:# From the menu at the top, click ''Extras'' to see downloads for previous versions.
=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.)
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.)
<li>[[#Reset your content files|Reset your content files]] or reinstall the game.<li>
<li>[[#Reset your content files|Reset your content files]] or reinstall the game.<li>
<li>Delete your <code>startup_preferences</code> file. (To find it: [[Saves#Find your save files|open your saves folder]], and it'll be in the folder that contains it.)</li>
<li>Delete your <code>startup_preferences</code> file. (To find it: [[Saves#Find your save files|open your saves folder]], and it'll be in the folder that contains it.)</li>
<li>Install the software for your graphics card ([https://www.nvidia.com/en-us/geforce/geforce-experience/ GeForce Experience] for NVIDIA or [https://www.amd.com/en/technologies/radeon-software Radeon Software] for AMD), then use that software to update to your latest graphics drivers. (See [https://www.tomsguide.com/how-to/what-graphics-card-do-i-have-heres-how-to-tell how to check which graphics card you have].)</li>
<li>Install the software for your graphics card ([https://www.nvidia.com/en-us/geforce/geforce-experience/ GeForce Experience] for NVIDIA or [https://www.amd.com/en/technologies/software AMD Software] for AMD), then use that software to update to your latest graphics drivers. (See [https://www.tomsguide.com/how-to/what-graphics-card-do-i-have-heres-how-to-tell how to check which graphics card you have].)</li>
<li>Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).</li>
<li>Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).</li>
<li>Delete <code>startup_preferences</code> This can be found on Windows at %appdata% > Stardew Valley > it's in that folder, or C:\Users\Yourwindowsnamehere\AppData\Roaming\StardewValley or for Mac can be found at ~/.config/StardewValley </li>
<li>Delete <code>startup_preferences</code> This can be found on Windows at %appdata% > Stardew Valley > it's in that folder, or C:\Users\Yourwindowsnamehere\AppData\Roaming\StardewValley or for Mac can be found at ~/.config/StardewValley </li>
<dt>2. (''Windows only'') Run the game on your dedicated graphics card:</dt>
<dt>2. (''Windows only'') Run the game on your dedicated graphics card:</dt>
<dd>[[File:SMAPI dedicated GPU on Windows.png|thumbnail|The 'high performance' option described in the steps on the left.]]
<dd>See [[#dedicated-gpu|''Run the game on your dedicated graphics card (Windows only)'']] above. Don't skip this step! It very often fixes the issue.</dd>
</dd>
<dt>3. Check if there's an error message:</dt>
<dt>3. Check if there's an error message:</dt>
</dl>
</dl>
=Specific error messages=
=="Could not load 'Stardew Valley' or one of its dependencies"==
=="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:
SMAPI wasn't able to load the game's executable. There's a number of possible reasons for this:
<dt>1. Update your graphics drivers:</dt>
<dt>1. Update your graphics drivers:</dt>
<dd><ol>
<dd><ol>
<li>Install the app for your graphics card ([https://www.nvidia.com/en-us/geforce/geforce-experience/ GeForce Experience] for NVIDIA or [https://www.amd.com/en/technologies/radeon-software Radeon Software] for AMD). If you're not sure, see [https://www.tomsguide.com/how-to/what-graphics-card-do-i-have-heres-how-to-tell how to check which graphics card you have].</li>
<li>Install the app for your graphics card ([https://www.nvidia.com/en-us/geforce/geforce-experience/ GeForce Experience] for NVIDIA or [https://www.amd.com/en/technologies/software AMD Software] for AMD). If you're not sure, see [https://www.tomsguide.com/how-to/what-graphics-card-do-i-have-heres-how-to-tell how to check which graphics card you have].</li>
<li>Open the app.</li>
<li>Open the app.</li>
<li>Find the section that shows graphics driver info. Make sure it says you have the latest version, and install any updates if not.</li>
<li>Find the section that shows graphics driver info. Make sure it says you have the latest version, and install any updates if not.</li>
<dt>2. (''Windows only'') Run the game on your dedicated graphics card:</dt>
<dt>2. (''Windows only'') Run the game on your dedicated graphics card:</dt>
<dd>[[File:SMAPI dedicated GPU on Windows.png|thumbnail|The 'high performance' option described in the steps on the left.]]
<dd>See [[#dedicated-gpu|''Run the game on your dedicated graphics card (Windows only)'']] above. Don't skip this step! It very often fixes the issue.</dd>
</dd>
<dt>3. Use the compatibility branch or an older version of Stardew Valley:</dt>
<dt>3. Use the compatibility branch or an older version of Stardew Valley:</dt>
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.
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.
==<samp>OutOfMemoryException</samp> errors (Windows only)==
==<samp>OutOfMemoryException</samp> errors==
Your log shows <samp>OutOfMemoryException</samp> errors in the console, and the game may severely lag or crash. That means your game ran out of available memory mid-session.
Your log shows <samp>OutOfMemoryException</samp> 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 <samp>Unable to allocate pixels for the bitmap</samp>.
Some common fixes:
Some common fixes:
* Make sure you have the latest Stardew Valley {{version|link=0}}, which is 64-bit and doesn't have the 32-bit limitations of older versions.
* Make sure you have the latest Stardew Valley {{version|link=0}}, 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 or TMXL Map Toolkit, which can use a lot of memory).
* 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:
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.<br />[[File:Screenshot 2022-01-08 140059.png|600px|thumb|none|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.
* '''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.
** 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.
* (Windows only) '''If you have a dedicated graphics card, run the game on it''' and not on the integrated graphics card. See [[#dedicated-gpu|''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.
* '''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==
==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 [https://www.openal.org/downloads/ OpenAl]. You can also try plugging in some headphones or connecting a bluetooth headset.
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 [https://www.openal.org/downloads/ 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 <code>Command+Shift+.</code>, 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 <code>~/.config/StardewValley/ErrorLogs</code> exists. If it doesn't exist, make it exist.
* Your screenshots button works. If it doesn't work, make sure the folder <code>~/.local/share/StardewValley/Screenshots</code> 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==
==Game lags or stutters in-game==
There's a few things you can try.
There's a few things you can try.
## Make sure there's no repeating errors in the SMAPI console window (if there are, see [[#Get help|''get help'']]).
## Make sure there's no repeating errors in the SMAPI console window (if there are, see [[#Get help|''get help'']]).
## 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.)
## 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.)
# For Windows players only, [[#Game doesn't launch|run the game on your dedicated graphics card]] (see subsection 2).
# For Windows players only:
## [[#dedicated-gpu|Run the game on your dedicated graphics card]].
## Install the software for your graphics card ([https://www.nvidia.com/en-us/geforce/geforce-experience/ GeForce Experience] for NVIDIA or [https://www.amd.com/en/technologies/software AMD Software] for AMD), then use that software to update to your latest graphics drivers. (See [https://www.tomsguide.com/how-to/what-graphics-card-do-i-have-heres-how-to-tell how to check which graphics card you have].)
## If using NVIDIA GeForce Experience, make sure WhisperMode is disabled.
# For Linux/SteamDeck players:
## From [[Modding:Game folder|your game folder]], open <samp>smapi-internal/config.json</samp> and set <samp>ListenForConsoleInput</samp> to false. (Note the instructions at the top of that file about creating a <samp>config.user.json</samp> file.)
# Add an exception in your antivirus software for the [[Modding:Player Guide/Getting Started#Find your game folder|Stardew Valley folder]]. You can search online for your antivirus name with the words ''add folder exception'' for instructions.<br />'''Note for Windows players:''' if didn't install an antivirus, you have Windows Defender by default and it ''can'' cause lag. Try [https://support.microsoft.com/en-us/windows/add-an-exclusion-to-windows-security-811816c0-4dfd-af4a-47e4-c301afe13b26 excluding the game folder] in that case.
# Add an exception in your antivirus software for the [[Modding:Player Guide/Getting Started#Find your game folder|Stardew Valley folder]]. You can search online for your antivirus name with the words ''add folder exception'' for instructions.<br />'''Note for Windows players:''' if didn't install an antivirus, you have Windows Defender by default and it ''can'' cause lag. Try [https://support.microsoft.com/en-us/windows/add-an-exclusion-to-windows-security-811816c0-4dfd-af4a-47e4-c301afe13b26 excluding the game folder] in that case.
# [https://www.thewindowsclub.com/processor-affinity-windows Set the processor affinity] for {{executable name|StardewModdingAPI}} (if using mods) or {{executable name|Stardew Valley}} (without mods) to 2 or higher.
# [https://www.thewindowsclub.com/processor-affinity-windows Set the processor affinity] for {{executable name|StardewModdingAPI}} (if using mods) or {{executable name|Stardew Valley}} (without mods) to 2 or higher.
==Game resolution changes when launched with SMAPI (Windows 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.
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|ask for help]].
<!--
This is usually due to Windows DPI settings.
# Common fix:
# Common fix:
'''Troubleshooting:'''
'''Troubleshooting:'''
* If you installed SMAPI using Vortex, you might not see the ''Compatibility'' section. In that case [[Modding:Installing SMAPI on Windows|install SMAPI using its installer]] instead (you can still use Vortex to manage mods after doing that).
* If you installed SMAPI using Vortex, you might not see the ''Compatibility'' section. In that case [[Modding:Installing SMAPI on Windows|install SMAPI using its installer]] instead (you can still use Vortex to manage mods after doing that).
-->
==Save disappeared or doesn't load==
==Save disappeared or doesn't load==
==Can't connect to another player in multiplayer==
==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. 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.
# Check your game setup:
# Make sure you have enough cabins built for the number of players.
## Make sure you have the latest Stardew Valley version ({{version|link=0}} on PC).
# Make sure everyone launches the game through Steam or GOG Galaxy (not a separate shortcut). On Windows, see [[Modding:Installing SMAPI on Windows#Configure your game client|''Configure your game client'' in the Windows install guide]].
## 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.
## Make sure you have enough cabins built for the number of players.
# 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.
## Make sure the server is set to online in the game options.
## [[#Reset your content files|Reset the content files for all players]].
## Delete your <code>startup_preferences</code> (found in <code>%appdata%/StardewValley</code> on Windows or <code>~/.config/StardewValley</code> on Linux/Mac).
# Make sure everyone launches the game through Steam or GOG Galaxy (not a separate shortcut). For SMAPI on Windows, see [[Modding:Installing SMAPI on Windows#Configure your game client|''Configure your game client'' in the Windows install guide]].
# 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.
# Restart all players' PCs.
# Restart all players' PCs.
# Restart all players' routers, and check for any [https://www.wikihow.com/Update-Router-Firmware updates for your router].
# Restart all players' routers, and check for any [https://www.wikihow.com/Update-Router-Firmware 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.
# 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) [[#Game doesn't launch|Check debugging steps under Game Doesn't Launch]].
# (Windows only) [[#Game doesn't launch|Check the debugging steps under ''Game doesn't launch'']].
# If you use mods and are getting a "version mismatch" error, check your log files for a line like <code>[19:49:26 TRACE game] Starting server. Protocol version: 1.4.0.1</code> and check whether the protocol version matches.
# If you use mods and are getting a "version mismatch" error, check your log files for a line like <code>[19:49:26 TRACE game] Starting server. Protocol version: {{version|link=0}}</code> 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 [https://edu.gcfglobal.org/en/basic-computer-skills/how-to-power-cycle-a-device/1/ power cycling] your console. Please note that all consoles require their paid online service to play over the internet.
For console players, please try all of the steps that apply (particularly the first four under 'check your game setup') and try [https://edu.gcfglobal.org/en/basic-computer-skills/how-to-power-cycle-a-device/1/ 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==
==SMAPI or mod files disappear, or they're blocked by your antivirus or browser<span id="antivirus"></span><span id="SMAPI_files_disappear_or_antivirus_complains"></span>==
Your antivirus might remove or report SMAPI/mod files. This is almost always a false positive, meaning the files don't contain a trojan.
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?'''
:; '''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 {{github|Pathoschild/SMAPI|reading the code}}, [https://www.jetbrains.com/decompiler/ decompiling the download], or [https://www.virustotal.com/ 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.)
:: Nothing on the Internet is guaranteed, but it's most likely safe — you can check by reading the code (e.g. see {{github|Pathoschild/SMAPI|SMAPI's code}}), [https://www.jetbrains.com/decompiler/ decompiling the download], or [https://www.virustotal.com/ 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?'''
:; '''Why does this happen?'''
:: Antiviruses are usually concerned because...
:: 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 <samp>Trojan:Win32/Emali.A!cl</samp> for this. Antiviruses learn to allow it after enough users download it, but that resets for each release.
::* 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 <samp>Trojan:Win32/Emali.A!cl</samp> 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).
::* 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?'''
:; '''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.
::* 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.
:; '''How can I install SMAPI or a mod if my antivirus flags it?'''
::* If you've checked that it's safe above, another option is to...
:: 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...
::*# Temporarily disable your antivirus.
::*# Temporarily disable your antivirus.
::*# Redownload and [[Modding:Player Guide/Getting Started#Getting started|install SMAPI]] or the mod.
::*# Redownload and [[Modding:Player Guide/Getting Started#Getting started|install SMAPI]] or the mod.
Common fixes:
Common fixes:
# Launch the game through Steam.
# Launch the game through Steam.
# Windows only: make sure you set the launch options (see [[Modding:Installing SMAPI on Windows#Configure your game client|''Configure your game client'' in the Windows install guide]]), don't add SMAPI as a non-Steam game.
# Windows only: make sure you set the launch options (see [[Modding:Installing SMAPI on Windows#Configure your game client|''Configure your game client'' in the Windows install guide]]).
# If all else fails, you can use third-party software to add controller support. Suggested software:
# If all else fails, you can use third-party software to add controller support. Suggested software:
#* Linux: {{github|kozec/sc-controller|SC Controller}}.
#* Linux: {{github|kozec/sc-controller|SC Controller}}.
==Pet event repeating over and over==
==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. 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.
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==
==SMAPI doesn't work with the compatibility branch==
; What is the compatibility branch?
; What is the compatibility branch?
: You have a few options.
: You have a few options.
<ol style="margin-left;">
<ol>
<li>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.</li>
<li>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.</li>
<li>''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.</li>
<li>''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.</li>
If you want to rollback to Stardew Valley 1.5.4, here's how:
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!
# Install [https://dotnet.microsoft.com/download/dotnet .NET 5 or later].
# Install [https://dotnet.microsoft.com/download/dotnet .NET 5 or later].
</li>
</li>
<li><p>''Or'' use a tool called DepotDLGUI designed to download 1.5.4 more easily using [{{github|SteamRE/DepotDownloader}} DepotDownloader].</p>
<li><p>''Or'' use a tool called DepotDLGUI designed to download 1.5.4 more easily using [{{github|SteamRE/DepotDownloader}} DepotDownloader].</p>
# Install .NET 5 or later. (Link above)
:Please note this only works on the '''Steam''' version of the game!
# Install [https://dotnet.microsoft.com/en-us/download/dotnet/5.0 .NET 5].
# Download the latest release of [{{github|AnotherPillow/StardewValley_DepotDLGUI}} DepotDLGui]. (Green Price Tag on the right side of the screen, under the word Releases)
# Download the latest release of [{{github|AnotherPillow/StardewValley_DepotDLGUI}} DepotDLGui]. (Green Price Tag on the right side of the screen, under the word Releases)
# Unzip the file you just downloaded.
# Unzip the file you just downloaded.
</ol>
</ol>
=Get help=
==Report a bug==
==Report a bug==
; If you play ''without'' mods
; If you play ''without'' mods
|next = [[Modding:Mod compatibility|Compatibility]]
|next = [[Modding:Mod compatibility|Compatibility]]
}}
}}
[[Category:Modding]]
[[de:Modding:Spieleranleitung/Problembehebung]]
[[de:Modding:Spieleranleitung/Problembehebung]]
[[es:Modding:Guía del jugador/Solución de problemas]]
[[es:Modding:Guía del jugador/Solución de problemas]]
[[zh:模组:使用指南/疑难解答]]
[[zh:模组:使用指南/疑难解答]]