Changes

Common fix:

Common fix:

# Right-click on <tt>StardewModdingAPI.exe</tt>, go to ''Properties'' > ''Compatibility'' > ''Change High DPI settings'', and keep it open.

# Right-click on <samp>StardewModdingAPI.exe</samp>, go to ''Properties'' > ''Compatibility'' > ''Change High DPI settings'', and keep it open.

# Right-click on <tt>StardewValley.exe</tt>, and go to ''Properties'' > ''Compatibility'' > ''Change High DPI settings''.

# Right-click on <samp>StardewValley.exe</samp>, and go to ''Properties'' > ''Compatibility'' > ''Change High DPI settings''.

# Change the DPI settings for <tt>StardewModdingAPI.exe</tt> so they match the ones for <tt>StardewValley.exe</tt>.

# Change the DPI settings for <samp>StardewModdingAPI.exe</samp> so they match the ones for <samp>StardewValley.exe</samp>.

===Save disappeared or doesn't load===

===Save disappeared or doesn't load===

:; '''Why does this happen?'''

:; '''Why does this happen?'''

:: Antiviruses are usually concerned because...

:: 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 <tt>Trojan:Win32/Emali.A!cl</tt> 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).

{{collapse|last resort on Linux/Mac|content=&#32;

{{collapse|last resort on Linux/Mac|content=&#32;

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 [https://log.smapi.io/ check the log], and your game won't launch after a crash until you delete the <tt>smapi-internal/StardewModdingAPI.crash.marker</tt> file. You should periodically check the log to make sure everything is working correctly. If you really want to do this:

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 [https://log.smapi.io/ check the log], and your game won't launch after a crash until you delete the <samp>smapi-internal/StardewModdingAPI.crash.marker</samp> file. You should periodically check the log to make sure everything is working correctly. If you really want to do this:

<ul>

<ul>

<ol>

<ol>

<li>[[Modding:Player Guide/Getting Started#Find your game folder|Find your game folder]].</li>

<li>[[Modding:Player Guide/Getting Started#Find your game folder|Find your game folder]].</li>

<li>Open the <tt>StardewValley</tt> file (the one with no file extension) in a text editor.</li>

<li>Open the <samp>StardewValley</samp> file (the one with no file extension) in a text editor.</li>

<li>Remove the entire section under <tt># open SMAPI in terminal</tt> (up to the next <code>fi</code> line).</li>

<li>Remove the entire section under <samp># open SMAPI in terminal</samp> (up to the next <code>fi</code> line).</li>

<li>Find this text at the bottom:

<li>Find this text at the bottom:

<syntaxhighlight lang="bash">

<syntaxhighlight lang="bash">

<ol>

<ol>

<li>[[Modding:Player Guide/Getting Started#Find your game folder|Find your game folder]].</li>

<li>[[Modding:Player Guide/Getting Started#Find your game folder|Find your game folder]].</li>

<li>Open the <tt>StardewValley</tt> file (the one with no file extension) in a text editor.</li>

<li>Open the <samp>StardewValley</samp> file (the one with no file extension) in a text editor.</li>

<li>Find this text:

<li>Find this text:

<syntaxhighlight lang="bash">open -a Terminal ./StardewModdingAPI.bin.osx $@</syntaxhighlight>

<syntaxhighlight lang="bash">open -a Terminal ./StardewModdingAPI.bin.osx $@</syntaxhighlight>

<li>If the above doesn't work.</li>

<li>If the above doesn't work.</li>

<li>[[Modding:Player Guide/Getting Started#Find your game folder|Find your game folder]].</li>

<li>[[Modding:Player Guide/Getting Started#Find your game folder|Find your game folder]].</li>

<li>Open the <tt>StardewValley</tt> file (the one with no file extension) in a text editor.</li>

<li>Open the <samp>StardewValley</samp> file (the one with no file extension) in a text editor.</li>

<li>Find this text:

<li>Find this text:

<syntaxhighlight lang="bash">SKIP_TERMINAL=false</syntaxhighlight>

<syntaxhighlight lang="bash">SKIP_TERMINAL=false</syntaxhighlight>

If you have multiple copies installed, the best solution is to only have one. To do that:

If you have multiple copies installed, the best solution is to only have one. To do that:

# Make a copy of your <tt>Mods</tt> folder somewhere else.

# Make a copy of your <samp>Mods</samp> folder somewhere else.

# Uninstall the game.

# Uninstall the game.

# Delete both folders you found above.

# Delete both folders you found above.

==="Could not load file or assembly"===

==="Could not load file or assembly"===

If the 'file or assembly' starts with <tt>Microsoft</tt> or <tt>System</tt> (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.

If the 'file or assembly' starts with <samp>Microsoft</samp> or <samp>System</samp> (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.

<ol>

<ol>

|-

|-

| Linux

| Linux

| reinstall [https://www.mono-project.com/download/stable/ <tt>mono-complete</tt>].

| reinstall [https://www.mono-project.com/download/stable/ <samp>mono-complete</samp>].

|-

|-

| Mac

| Mac

</ol>

</ol>

===<tt>OutOfMemoryException</tt> errors (Windows only)===

===<samp>OutOfMemoryException</samp> errors (Windows only)===

Your log shows <tt>OutOfMemoryException</tt> errors in the console, and the game may severely lag or crash. That means your game ran out of available memory mid-session, which can happen even if your computer has plenty of physical memory available due to 32-bit limitations.

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, which can happen even if your computer has plenty of physical memory available due to 32-bit limitations.

Some common fixes:

Some common fixes: