Changes

; Option 2: create retroactive backup to reset any file

; Option 2: create retroactive backup to reset any file

: If you installed XNB mods and want to reset one file you know is broken, you can just restore the original file. If you forgot to back it up, here's how to recover the original files without losing your modded ones:

: 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 <tt>Content</tt> folder to <tt>Content-modded</tt>.

:# 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/212807405 for GOG Galaxy]).

:# 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/212807405 for GOG Galaxy]).

:# Copy your (now reset) <tt>Content</tt> folder to <tt>Content-backup</tt>.

:# Copy your (now reset) <code>Content</code> folder to <code>Content-backup</code>.

:# Move <tt>Content-modded</tt> back to <tt>Content</tt>.

:# Move <code>Content-modded</code> back to <code>Content</code>.

: Now your content files are still modded, but you have a backup of the original files.

: Now your content files are still modded, but you have a backup of the original files.

==Fix common error messages==

==Fix common error messages==

==="SMAPI can't find the game"===

==="SMAPI can't find the game"===

* Make sure you're running <tt>StardewModdingAPI.exe</tt> in your game folder (see the [[Modding:Installing SMAPI|install instructions]]).

* Make sure you're running <code>StardewModdingAPI.exe</code> in your game folder (see the [[Modding:Installing SMAPI|install instructions]]).

* Did you install SMAPI manually (not using <tt>install.exe</tt>)? Make sure you copied the right files: <tt>internal/Windows</tt> for Windows, or <tt>internal/Mono</tt> for Linux/Mac.

* Did you install SMAPI manually (not using <code>install.exe</code>)? Make sure you copied the right files: <code>internal/Windows</code> for Windows, or <code>internal/Mono</code> for Linux/Mac.

==="SMAPI doesn't seem to be compatible with your game"===

==="SMAPI doesn't seem to be compatible with your game"===

==="Skipped '...' because it doesn't have a manifest.json"===

==="Skipped '...' because it doesn't have a manifest.json"===

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

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

==="InvalidOperationException: This resource could not be created"===

==="InvalidOperationException: This resource could not be created"===

* Close your browsers and any open apps before playing. (You can reopen them once the game is started.)

* Close your browsers and any open apps before playing. (You can reopen them once the game is started.)

* Remove any mods that change the game's audio (e.g. mods which add more music).

* Remove any mods that change the game's audio (e.g. mods which add more music).

* '''(experimental)''' If you have 64-bit Windows with at least 3GB of RAM, use the [https://www.techpowerup.com/forums/threads/large-address-aware.112556/ Large Address Aware] tool on <tt>StardewModdingAPI.exe</tt> and <tt>Stardew Valley.exe</tt>. (You'll need to reapply it when you update the game or SMAPI.)

* '''(experimental)''' If you have 64-bit Windows with at least 3GB of RAM, use the [https://www.techpowerup.com/forums/threads/large-address-aware.112556/ Large Address Aware] tool on <code>StardewModdingAPI.exe</code> and <code>Stardew Valley.exe</code>. (You'll need to reapply it when you update the game or SMAPI.)

===Steam: "missing executable"===

===Steam: "missing executable"===

# Make sure you download and install [http://mono-project.com/ Mono].

# Make sure you download and install [http://mono-project.com/ Mono].

# Restart your computer and try again.

# Restart your computer and try again.

# On Mac, you can also [https://brew.sh install Homebrew] and run <tt>brew install mono mono-libgdiplus</tt> in the Terminal app.

# On Mac, you can also [https://brew.sh install Homebrew] and run <code>brew install mono mono-libgdiplus</code> in the Terminal app.

==Fix other issues==

==Fix other issues==

# If you've already installed SMAPI, blank the Steam launch options so it runs the game without SMAPI.

# If you've already installed SMAPI, blank the Steam launch options so it runs the game without SMAPI.

# [[Modding:Game folder|Open your game folder]].

# [[Modding:Game folder|Open your game folder]].

# Open the <tt>_CommonRedist</tt> folder, then <tt>XNA</tt> inside that, then <tt>4.0</tt>.

# Open the <code>_CommonRedist</code> folder, then <code>XNA</code> inside that, then <code>4.0</code>.

# Run the <tt>xnafx40_redist.msi</tt> file.

# Run the <code>xnafx40_redist.msi</code> file.

# Restart your computer.

# Restart your computer.

# Launch the game.

# Launch the game.

===Other problems===

===Other problems===

Run the game without SMAPI by launching <tt>Stardew Valley.exe</tt> (on Windows) or <tt>StardewValley-original</tt> (on Linux/Mac) in your [[Modding:Game folder|game folder]].

Run the game without SMAPI by launching <code>Stardew Valley.exe</code> (on Windows) or <code>StardewValley-original</code> (on Linux/Mac) in your [[Modding:Game folder|game folder]].

* If it still happens '''without''' SMAPI: see [https://steamcommunity.com/app/413150/discussions/0/142261352650065356/ this guide to fixing your game]. If you still need help, [[#Ask for help|ask for help]].

* If it still happens '''without''' SMAPI: see [https://steamcommunity.com/app/413150/discussions/0/142261352650065356/ this guide to fixing your game]. If you still need help, [[#Ask for help|ask for help]].

|-

|-

| Windows

| Windows

| <tt>%appdata%\StardewValley\ErrorLogs\SMAPI-latest.txt</tt><br /><small>(Paste "<tt>%appdata%</tt>" into the address bar, Windows knows where it is.)</small>

| <code>%appdata%\StardewValley\ErrorLogs\SMAPI-latest.txt</code><br /><small>(Paste "<code>%appdata%</code>" into the address bar, Windows knows where it is.)</small>

|-

|-

| Linux

| Linux

| <tt>~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt</tt><br /><small>(The folder is hidden by default. From Files, click ''Go » Enter Location'' and enter "~/.config".)</small>

| <code>~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt</code><br /><small>(The folder is hidden by default. From Files, click ''Go » Enter Location'' and enter "~/.config".)</small>

|-

|-

| Mac

| Mac

| <tt>~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt</tt><br /><small>(The folder is hidden by default. From Finder, click ''Go » Go to Folder'' and enter "~/.config".)</small>

| <code>~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt</code><br /><small>(The folder is hidden by default. From Finder, click ''Go » Go to Folder'' and enter "~/.config".)</small>

|}

|}

</li>

</li>