Changes

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!)

<h1 style="border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em; margin-bottom:0;">The basics</h1>

=The basics=

 

==Common fixes==

==Common fixes==

# Restart your computer.

# Restart your computer.

}}

}}

<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>

==FAQs about Stardew Valley 1.5.5==

==FAQs about Stardew Valley 1.5.5==

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

: 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.

<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>

=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.)

</dl>

</dl>

<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>

=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:

==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.

<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>

=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.

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.

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.

<h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;">Known issues</h1>

=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>

</ol>

</ol>

<h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;">Get help</h1>

=Get help=

 

==Report a bug==

==Report a bug==

; If you play ''without'' mods

; If you play ''without'' mods