Changes

Jump to navigation Jump to search
Line 8: Line 8:  
# Make sure you have Stardew Valley {{version|link=0}} or later.<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 {{version|link=0}} or later.<br /><small>Click the "?" button on the title screen, and the version will appear in the bottom-left.</small>
 
# If you use SMAPI, make sure you have the [https://smapi.io/ latest version of that].<br /><small>The SMAPI version is shown at the top of the SMAPI console window.</small>
 
# If you use SMAPI, make sure you have the [https://smapi.io/ latest version of that].<br /><small>The SMAPI version is shown at the top of the SMAPI console window.</small>
 +
# 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. Check here[TBA] for more information on how to read and understand your log.
 +
# The very top of your log will show a list of all your mods that need to be updated. 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.'''
 
# 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.'''
Line 20: Line 22:  
:::* Most framework mods, like Content Patcher, Json Assets, Custom Furniture, or TMXL Map Toolkit (formerly TMXLoader), support content packs, separate mods that use the framework's code as a base to add or change content. These will be in folders that look like <code>[CP] Apples Nowhere</code>; sometimes that folder will be bundled together in a subfolder with parts of the mod that use other frameworks, like an <code>Apples Nowhere</code> folder with <code>[CP] Apples Nowhere</code> and <code>[JA] Apples Nowhere Objects</code> inside. Most content packs for framework mods should go directly into your Mods folder and will have their own manifests.  
 
:::* Most framework mods, like Content Patcher, Json Assets, Custom Furniture, or TMXL Map Toolkit (formerly TMXLoader), support content packs, separate mods that use the framework's code as a base to add or change content. These will be in folders that look like <code>[CP] Apples Nowhere</code>; sometimes that folder will be bundled together in a subfolder with parts of the mod that use other frameworks, like an <code>Apples Nowhere</code> folder with <code>[CP] Apples Nowhere</code> and <code>[JA] Apples Nowhere Objects</code> inside. Most content packs for framework mods should go directly into your Mods folder and will have their own manifests.  
 
::::* A number of framework mods have older documentation floating around from versions where content packs were not supported and you would have to put the pack into the main mod's folder. Most of the time this isn't true, but certain mods, like More Giant Crops, Adopt and Skin or Custom Critters, don't have content pack support. ''Make sure to read the instructions on the framework mod's page for how to install content packs!'' Sometimes "no manifest" errors come from trying to install a pack that purposely has no manifest because it needs to go into one of the folders inside the main framework mod.
 
::::* A number of framework mods have older documentation floating around from versions where content packs were not supported and you would have to put the pack into the main mod's folder. Most of the time this isn't true, but certain mods, like More Giant Crops, Adopt and Skin or Custom Critters, don't have content pack support. ''Make sure to read the instructions on the framework mod's page for how to install content packs!'' Sometimes "no manifest" errors come from trying to install a pack that purposely has no manifest because it needs to go into one of the folders inside the main framework mod.
::* If you see an error ending with <code>because you have multiple copies of this mod installed</code>, the log parser will tell you the folders your extra copies are in. This is often caused by mods changing folder names, forgetting to remove old copies from your organizational subfolders when updating, or being inconsistent with whether you take everything out of the mod's subfolder when updating or leave it together. <small>(ex. when you first downloaded Artisan Valley, you took the <code>[CP]</code> <code>[JA]</code> <code>[PFM]</code> folders out of the <code>[PPJA] Artisan Valley</code> folder, but when you updated it, you put the whole <code>[PPJA]</code> folder 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.
<ol><li value="7">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. You can also always [https://stardewvalleywiki.com/Modding:Help#Using_mods ask for help!]</li></ol>
+
# 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!]
    
===<span id="reset-content">Reset your content files</span>===
 
===<span id="reset-content">Reset your content files</span>===
38

edits

Navigation menu