translators
8,438
edits
Changes
Jump to navigation
Jump to search
Line 61:
Line 61: − + Line 68:
Line 68: + + + Line 75:
Line 78: + + + + + + + + Line 205:
Line 216: − + Line 226:
Line 237: − − ===Game freezes when loading a save (Mac only)=== − '''On Mac only''', the game may freeze when you create or load a save; reinstalling [https://www.mono-project.com/download/stable/ Mono] (either version) usually fixes that. If it doesn't, [[#ask for help|ask for help]]! − − ===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. − − Common fix: − # Right-click on <tt>StardewModdingAPI.exe</tt>, 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''. − # Change the DPI settings for <tt>StardewModdingAPI.exe</tt> so they match the ones for <tt>StardewValley.exe</tt>.
Modding:Player Guide/Troubleshooting (view source)
Revision as of 17:32, 10 May 2021
, 17:32, 10 May 2021fix incorrect section grouping
## [[#Ask for help|Ask for help and attach your SMAPI log]].
## [[#Ask for help|Ask for help and attach your SMAPI log]].
===Game freezes or crashes while opening===
===Game freezes or crashes while launching===
The game tries to open, but crashes before the title screen. Here are some common fixes:
The game tries to open, but crashes before the title screen. Here are some common fixes:
# Try everything in the list above first.
# Try everything in the list above first.
# Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).
# Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).
# If that doesn't fix it, follow the steps to [[#Ask for help|ask for help]].
# If that doesn't fix it, follow the steps to [[#Ask for help|ask for help]].
===Game freezes when loading a save (macOS only)===
'''On Mac only''', the game may freeze when you create or load a save; reinstalling [https://www.mono-project.com/download/stable/ Mono] (either version) usually fixes that. If it doesn't, [[#ask for help|ask for help]]!
===Game audio doesn't play (Windows only)===
===Game audio doesn't play (Windows only)===
# Make sure the in-game sound slider options aren't muted.
# Make sure the in-game sound slider options aren't muted.
# [[#Game doesn't launch|Reinstall .NET Framework 4.5.2 and XNA Framework 4.0]].
# [[#Game doesn't launch|Reinstall .NET Framework 4.5.2 and XNA Framework 4.0]].
===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.
Common fix:
# Right-click on <tt>StardewModdingAPI.exe</tt>, 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''.
# Change the DPI settings for <tt>StardewModdingAPI.exe</tt> so they match the ones for <tt>StardewValley.exe</tt>.
===Save disappeared or doesn't load===
===Save disappeared or doesn't load===
* If that shows an error or it still doesn't work, you can [https://brew.sh install Homebrew] and run <code>brew install mono mono-libgdiplus</code> in the Terminal app.
* If that shows an error or it still doesn't work, you can [https://brew.sh install Homebrew] and run <code>brew install mono mono-libgdiplus</code> in the Terminal app.
===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 <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.
<li>On Windows only, in rare cases that won't fix the issue. Unfortunately that's hard to fix since .NET Framework is part of Windows itself. In those cases you may need to [https://support.microsoft.com/en-us/help/4026528/windows-reset-or-reinstall-windows-10 perform a Windows reset] (you can keep your files), ''or'' perform a clean reinstall of Windows. This is drastic, but should fix the issue.</li>
<li>On Windows only, in rare cases that won't fix the issue. Unfortunately that's hard to fix since .NET Framework is part of Windows itself. In those cases you may need to [https://support.microsoft.com/en-us/help/4026528/windows-reset-or-reinstall-windows-10 perform a Windows reset] (you can keep your files), ''or'' perform a clean reinstall of Windows. This is drastic, but should fix the issue.</li>
</ol>
</ol>
===<tt>OutOfMemoryException</tt> errors (Windows only)===
===<tt>OutOfMemoryException</tt> errors (Windows only)===