translators
8,403
edits
Changes
Jump to navigation
Jump to search
Line 164:
Line 164: − + − + − * Make sure you have the [https://github.com/Pathoschild/SMAPI/releases latest version of SMAPI].<br /><small>The SMAPI version is shown at the top of the SMAPI console window.</small>+ − * Reboot and try again.+ + + + + + + + + + + + + + − + − − − + − * 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. − ===StardewModdingAPI.exe disappears===+ − Some antivirus programs may remove or complain about SMAPI. This is based on ''heuristic detection'' — SMAPI rewrites your mods so they work on your computer, and rewriting files is something trojans also do, so your antivirus got suspicious. SMAPI doesn't have a trojan (you can can [https://github.com/Pathoschild/SMAPI read the code] or [https://www.jetbrains.com/decompiler/ decompile the download] to check), so you just need to tell your antivirus that SMAPI is okay. Try searching online for your antivirus name with the words "add exception" to find instructions.+
→Troubleshooting: further expand & reorganise
==Troubleshooting==
==Troubleshooting==
===Common fixes===
===Fix common error messages===
* Make sure you have Stardew Valley 1.2.30 or later.<br /><small>Click the "?" button on the title screen, and the version will appear in the bottom-left. If SMAPI is crashing, launch <tt>Stardew Valley.exe</tt> (Windows) or <tt>StardewValley-original</tt> (Linux/Mac) to play without SMAPI.</small>
* ''"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.
===StardewModdingAPI.exe disappears or your antivirus complains===
Some antivirus programs may remove or complain about SMAPI. This is based on ''heuristic detection'' — SMAPI rewrites your mods so they work on your computer, and rewriting files is something trojans also do, so your antivirus got suspicious. SMAPI doesn't have a trojan (you can can [https://github.com/Pathoschild/SMAPI read the code] or [https://www.jetbrains.com/decompiler/ decompile the download] to check), so you just need to tell your antivirus that SMAPI is okay. Try searching online for your antivirus name with the words "add exception" to find instructions.
===Check your versions===
# Make sure you have the [https://github.com/Pathoschild/SMAPI/releases 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.<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===
Many problems are caused by broken files in the game's <tt>Content</tt> folder (especially if you installed an old XNB mod). You can reset your game files to default; this won't affect SMAPI mods, but any XNB mods will need to be reinstalled.
Many problems are caused by broken files in the game's <tt>Content</tt> folder (especially if you installed an old XNB mod). You can reset your game files to default; this won't affect SMAPI mods, but any XNB mods will need to be reinstalled. See:
See:
* [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 Instructions for Steam]
* [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 Instructions for Steam]
* [https://support.gog.com/hc/en-us/articles/212807405 Instructions for GOG Galaxy]
* [https://support.gog.com/hc/en-us/articles/212807405 Instructions for GOG Galaxy]
==="Oops! SMAPI can't find the game."===
===Other problems===
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 only happens '''with''' SMAPI: see [[#Asking for help|asking for help]].
==Asking for help==
==Asking for help==