Changes

Jump to navigation Jump to search
Line 12: Line 12:  
# If you use SMAPI, upload a log to [https://smapi.io/log the log parser], following the instructions on that page to find where your log is stored. It can help you diagnose common errors.
 
# If you use SMAPI, upload a log to [https://smapi.io/log the log parser], following the instructions on that page to find where your log is stored. It can help you diagnose common errors.
 
# The very top of your log will show a list of all your mods that need to be updated with links to the mods. You can also use [https://www.nexusmods.com/stardewvalley/mods/2536 Mod Update Menu] to keep track of your updates from the in-game menu. '''The first thing to try when you're having issues with mods is to update everything shown there, even if some of the mods seem to be working fine right now.'''
 
# The very top of your log will show a list of all your mods that need to be updated with links to the mods. You can also use [https://www.nexusmods.com/stardewvalley/mods/2536 Mod Update Menu] to keep track of your updates from the in-game menu. '''The first thing to try when you're having issues with mods is to update everything shown there, even if some of the mods seem to be working fine right now.'''
# Check the part of your log under the list of mods you're using, below where it says <code>Filter messages:</code> That will show a list of warnings. The warnings in orange text under <code>Changed save serializer</code>, the list of mods under <code>Patched game code</code>, and the list of mods with <code>No update keys</code> can generally be ignored at first. '''The most important part to look at is this section in red:'''
  −
<pre style="white-space:pre-wrap; width:55%; color:red; margin-left:60px;">16:56:04 ERROR SMAPI    Skipped mods
  −
16:56:04 ERROR SMAPI   -------------------------------------------------- 
  −
16:56:04 ERROR SMAPI       These mods could not be added to your game.</pre>
  −
::* If you see an error ending with <code>because it's no longer compatible</code>, the mod didn't load because it's too outdated. Check [https://smapi.io/mods the compatibility page] to see if there's a working unofficial update.
  −
::* If you see an error ending with <code>because it's not a SMAPI mod</code> or <code>because it doesn't have a manifest.json</code>, you've either tried to install an outdated XNB mod by putting it into your Mods folder (see [https://smapi.io/xnb this page] for more information), or a mod was installed incorrectly so SMAPI can't read it as a mod.
  −
:::* Mods need to have a correctly formatted <code>manifest.json</code> file in the correct folder level in order for SMAPI to read them. If you've installed a mod that SMAPI is telling you may be an XNB, or you get an error in your log about a mod that doesn't have a manifest, double check that it's installed correctly. <br><small>When you unzip mods, the folder for the mod should never look like <code>PineapplesEverywhere-1.0.4.zip-500-1-0-4-1547827625</code>--if it does, there may be loose files like a readme.txt, example images, or stray junk files directly inside that folder and SMAPI won't be able to find the manifest. To fix this, find the <code>PineapplesEverywhere</code> folder inside of that folder and drag it into Mods.</small>
   
# If you've narrowed down the issue to a specific mod or group of mods, try performing a clean reinstall. Remove all folders for the mod that's causing the issue, making sure to check the mod page for a list of every folder that's included. (If you're downloading mods from Nexus, you can look under "Preview File Contents." On ModDrop, you can find that information under "Files" on the sidebar.) Then, redownload the mod and follow the installation instructions on the mod page. If you normally use a mod manager, reinstall the mod manually to make sure your issue wasn't caused by the mod manager placing files in the wrong locations.
 
# If you've narrowed down the issue to a specific mod or group of mods, try performing a clean reinstall. Remove all folders for the mod that's causing the issue, making sure to check the mod page for a list of every folder that's included. (If you're downloading mods from Nexus, you can look under "Preview File Contents." On ModDrop, you can find that information under "Files" on the sidebar.) Then, redownload the mod and follow the installation instructions on the mod page. If you normally use a mod manager, reinstall the mod manually to make sure your issue wasn't caused by the mod manager placing files in the wrong locations.
 
# If you've gone through these steps and are still having problems, the issue may be caused by an outdated XNB mod. Follow the instructions below to try resetting your content files. If you still get the error, look through the common issues on this page or [https://stardewvalleywiki.com/Modding:Help#Using_mods ask for help!]
 
# If you've gone through these steps and are still having problems, the issue may be caused by an outdated XNB mod. Follow the instructions below to try resetting your content files. If you still get the error, look through the common issues on this page or [https://stardewvalleywiki.com/Modding:Help#Using_mods ask for help!]
38

edits

Navigation menu