Changes

==Troubleshooting==

==Troubleshooting==

===Common fixes===

===Common fixes===

Let's run through a quick checklist:

* 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>

# Are you running the latest versions? The versions are listed in the first line of the console window:<br />[[File:Modding - player FAQs - console version numbers.png]]<br />Make sure you have [[Version History|Stardew Valley 1.2.30+]] and the [https://github.com/Pathoschild/SMAPI/releases latest version of SMAPI].

# Are you using a Stardew Valley mod manager? Those are still experimental, so they can cause problems. Try downloading the mod manually.

* 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.

===Could not load file or assembly 'Stardew Valley'===

==="Oops! SMAPI doesn't seem to be compatible with your game."===

That error means SMAPI couldn't find your <tt>Stardew Valley.exe</tt> (Windows) or <tt>StardewValley.exe</tt> (Linux/Mac) file, probably because SMAPI isn't in the right folder. Make sure you're running <tt>StardewModdingAPI.exe</tt> in your [[#Game folder|game folder]], ''not'' the one in the downloaded installer folder. See the [[#Install SMAPI|install instructions]] for detailed steps.

Make sure you have Stardew Valley 1.2.30 or later.

===Ignored folder "..." which doesn't have a manifest.json===

==="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.

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.

===SMAPI contains a trojan?===

===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.

 

 

: Some antivirus programs may warn you that SMAPI contains a trojan with scary names like "Peals.A!cl". Don't worry, SMAPI doesn't actually have a trojan. That warning is based on something called a ''heuristic detection'' — basically the antivirus looked at the SMAPI code, and saw something trojan-like. That's because SMAPI can rewrite your mods so they work on your computer (mainly so players can use the same mods on Linux, Mac, or Windows). Rewriting files is something trojans also do, so your antivirus got suspicious.

 

; How do I know it doesn't ''really'' have a trojan?

 

: You can check! SMAPI is all open-source, so you can [https://github.com/Pathoschild/SMAPI read the code] to make sure it's not doing anything shady. If you don't trust the download, you can [https://www.jetbrains.com/decompiler/ decompile it] and see what code it really contains.

 

 

: You just need to tell your antivirus that SMAPI is okay. How you do that depends on which program you use. Try searching online for your antivirus name with the words "add exception" to find answers.

==Asking for help==

==Asking for help==