translators
8,411
edits
Changes
Jump to navigation
Jump to search
Line 3:
Line 3: − + − + − + − Before trying to troubleshoot a specific issue: − − + − − ===Fix common error messages=== − ; "''Oops! 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]]). − :* 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. − − ; "''Oops! SMAPI doesn't seem to be compatible with your game.''" − : Make sure you have Stardew Valley 1.2.30 or later. − − ; "''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. − − ; "''InvalidOperationException: This resource could not be created''" − : This usually means you have no speakers or headphones plugged in, which the game can't handle. Make sure you plug in an audio device (but it can be muted). − − ; "''SEHException: External component has thrown an exception''" − : The game crashed while preparing its audio, usually because it ran out of available memory. This isn't caused by SMAPI directly, though SMAPI uses a bit more memory. Common solutions: − :* Make sure your audio is plugged in (e.g. speakers or headphones). − :* Restart your computer. − :* 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). − :* '''(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>Stardew Valley.exe</tt>. − − ===SMAPI files disappear or your antivirus complains=== − Your antivirus might remove or complain about some SMAPI files. This is based on ''heuristic detection'' — SMAPI rewrites mods so they work on your computer, and rewriting files is something malware also does, so your antivirus got suspicious. Antiviruses learn to allow SMAPI after enough users download it, but this resets for each release. SMAPI doesn't have a trojan — you can check by [https://github.com/Pathoschild/SMAPI reading the code], [https://www.jetbrains.com/decompiler/ decompiling the download], or [https://www.virustotal.com/ uploading it to VirusTotal]. − − If this happens, here's how to fix it: − − # Temporarily disable your antivirus. − # [[Modding:Installing SMAPI|Install SMAPI]]. − # Add an exception to your antivirus for the [[#Game folder|Stardew Valley folder]] (search online for your antivirus name with the words ''add folder exception'' for instructions). Line 66:
Line 32: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 73:
Line 70: − + − + − + Line 98:
Line 95: − +
Modding:Player Guide/Troubleshooting (view source)
Revision as of 02:15, 28 April 2018
, 02:15, 28 April 2018reorganise & tweak
Did something go wrong with your mods? This is the page for you.
Did something go wrong with your mods? This is the page for you.
==Common fixes==
==Troubleshooting==
===The basics===
===Before you start===
# Try restarting your computer.
# Make sure you have the [https://smapi.io/ latest version of SMAPI].<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 SMAPI].<br /><small>The SMAPI version is shown at the top of the SMAPI console window.</small>
# Make sure you have Stardew Valley 1.2.30 or later (1.2.33 recommended).<br /><small>Click the "?" button on the title screen, and the version will appear in the bottom-left.</small>
# Make sure you have Stardew Valley 1.2.33 or later.<br /><small>Click the "?" button on the title screen, and the version will appear in the bottom-left.</small>
===Reset your content files===
===Reset your content files===
:# 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.
==Fix common error messages==
==="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]]).
* 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.
==="SMAPI doesn't seem to be compatible with your game"===
Make sure you have Stardew Valley 1.2.30 or later.
==="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.
==="InvalidOperationException: This resource could not be created"===
: This usually means you have no speakers or headphones plugged in, which the game can't handle. Make sure you plug in an audio device (but it can be muted).
==="SEHException: External component has thrown an exception"===
The game crashed while preparing its audio, usually because it ran out of available memory. This isn't caused by SMAPI directly, though SMAPI uses a bit more memory. Common solutions:
* Make sure your audio is plugged in (e.g. speakers or headphones).
* Restart your computer.
* 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).
* '''(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>Stardew Valley.exe</tt>.
===SMAPI files disappear or your antivirus complains===
Your antivirus might remove or complain about some SMAPI files. This is based on ''heuristic detection'' — SMAPI rewrites mods so they work on your computer, and rewriting files is something malware also does, so your antivirus got suspicious. Antiviruses learn to allow SMAPI after enough users download it, but this resets for each release. SMAPI doesn't have a trojan — you can check by [https://github.com/Pathoschild/SMAPI reading the code], [https://www.jetbrains.com/decompiler/ decompiling the download], or [https://www.virustotal.com/ uploading it to VirusTotal].
If this happens, here's how to fix it:
# Temporarily disable your antivirus.
# [[Modding:Installing SMAPI|Install SMAPI]].
# Add an exception to your antivirus for the [[#Game folder|Stardew Valley folder]] (search online for your antivirus name with the words ''add folder exception'' for instructions).
===Controller misbehaves (Steam only)===
===Controller misbehaves (Steam only)===
Run the game without SMAPI by launching <tt>Stardew Valley.exe</tt> (on Windows) or <tt>StardewValley-original</tt> (on Linux/Mac) in your [[#Game folder|game folder]].
Run the game without SMAPI by launching <tt>Stardew Valley.exe</tt> (on Windows) or <tt>StardewValley-original</tt> (on Linux/Mac) in your [[#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, see [[#Asking for help|asking 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]].
* If it only happens '''with''' SMAPI: see [[#Asking for help|asking for help]].
* If it only happens '''with''' SMAPI, [[#Ask for help|ask for help]].
==Asking for help==
==Ask for help==
===Find help===
===Find help===
For help with a mod, the mod author is the best person to ask. These are the best ways to contact them:
For help with a mod, the mod author is the best person to ask. These are the best ways to contact them:
#* Do you use a mod manager? If so, which one?
#* Do you use a mod manager? If so, which one?
#* Do you play on Linux, Mac, or Windows?
#* Do you play on Linux, Mac, or Windows?
# Cause the problem again (so any details are in the log), then attach a copy of the latest log file (see next section).
# Upload your SMAPI log to [https://log.smapi.io/ log.smapi.io] (see instructions on that page), and add a link to your message.