105,780
edits
Changes
Jump to navigation
Jump to search
Line 12:
Line 12: − + Line 23:
Line 23: − + − + + + + Line 31:
Line 34: − + Line 39:
Line 42: − + − + Line 47:
Line 50: − + − ; Do I need NET 5.0?+ − − + − + + + + + + + + + + + + + + + + + + + + + − + − + + + + + + + + + + Line 66:
Line 97: − + Line 89:
Line 120: − + − − Many computers have two options for running games: ''integrated graphics'' (part of the processor) and ''dedicated graphics'' (a separate graphics card by NVIDIA or AMD). Stardew Valley should be run on the dedicated graphics, but that's not always the default (especially on laptops). If you're not sure if this applies to your computer, it's safe to just try the instructions below anyway — they just won't do anything if it doesn't apply. − − To fix this: − − # From the start menu, search for ''Graphics Settings'' and open it. − # In the window that opens, click "Browse" near the top and choose {{executable name|StardewModdingAPI}} in [[Modding:Player Guide/Getting Started#Find your game folder|your game folder]] (or {{executable name|Stardew Valley}} if you play without mods). − # In the app list, click "Options" under <samp>StardewModdingAPI</samp> (or <samp>Stardew Valley</samp> if you play without mods). − # Change the Graphics preference to "High performance". − # Save. − # Check whether it launches fine now. − Line 160:
Line 179: − + Line 166:
Line 185: − + − − Many computers have two options for running games: ''integrated graphics'' (part of the processor) and ''dedicated graphics'' (a separate graphics card by NVIDIA or AMD). Stardew Valley should be run on the dedicated graphics, but that's not always the default (especially on laptops). If you're not sure if this applies to your computer, it's safe to just try the instructions below anyway — they just won't do anything if it doesn't apply. − − To fix this: − − # From the start menu, search for ''Graphics Settings'' and open it. − # In the window that opens, click "Browse" near the top and choose {{executable name|StardewModdingAPI}} in [[Modding:Player Guide/Getting Started#Find your game folder|your game folder]] (or {{executable name|Stardew Valley}} if you play without mods). − # In the app list, click "Options" under <samp>StardewModdingAPI</samp> (or <samp>Stardew Valley</samp> if you play without mods). − # Change the Graphics preference to "High performance". − # Save. − # Check whether it launches fine now. − Line 213:
Line 220: + + Line 223:
Line 232: − + + + + + + + + + + + + Line 237:
Line 257: − + + + + + + Line 293:
Line 318: − + − + − + − − :: For mods, you can check by [https://www.jetbrains.com/decompiler/ decompiling them] or [https://www.virustotal.com/ uploading to VirusTotal] too. Note that every file downloaded from Nexus Mods is scanned before it's available. − + − + + + + − + − + + + Line 317:
Line 345: − + Line 399:
Line 427: + + Line 408:
Line 438: + + + Line 436:
Line 469: + +
no edit summary
# If you use SMAPI:
# 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>
## 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>
## 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. Take a look at this [https://stardewmodding.miraheze.org/wiki/Tutorial:_How_to_read_your_SMAPI_log annotated log] for more information on how to read and understand your log.
## 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. Take a look at this [https://stardewmodding.wiki.gg/wiki/Tutorial:_How_to_read_your_SMAPI_log annotated log] for more information on how to read and understand your log.
### If the parser website says the log is too big, or it takes too long to parse, you can open it up in any text editor (Notepad or Notepad++ work; on Mac TextEditor works), then copy from the very top of the log to the bottom of the first couple errors, and parse that.
### If the parser website says the log is too big, or it takes too long to parse, you can open it up in any text editor (Notepad or Notepad++ work; on Mac TextEditor works), then copy from the very top of the log to the bottom of the first couple errors, and parse that.
## The very top of your log will show a list of all your mods that need to be updated. You can also use {{nexus mod|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. You can also use {{nexus mod|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.'''
Many problems are caused by broken game files (especially if you [[Modding:Using XNB mods|use XNB mods]]). You can reset your game files to fix that. SMAPI mods won't be affected.
Many problems are caused by broken game files (especially if you [[Modding:Using XNB mods|use XNB mods]]). You can reset your game files to fix that. SMAPI mods won't be affected.
# See instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam] or [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy].
# See the instructions for your platform:
# If you use SMAPI on Linux/Mac, reinstall SMAPI to fix the launcher.
#* [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam];
#* [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy];
#* [https://support.xbox.com/en-US/help/games-apps/troubleshooting/troubleshoot-games-windows-10 for Xbox App for PC / PC Game Pass] (under ''Problems launching a game from the Xbox app'' and then ''Repair the game'').
# If you use SMAPI on Linux or macOS, reinstall SMAPI to fix the launcher.
{{collapse|more options|css=border: 1px solid #666; margin-top: 1em; padding: 0.2em;|content=If you don't want to reset ''all'' files, you have some other options.
{{collapse|more options|css=border: 1px solid #666; margin-top: 1em; padding: 0.2em;|content=If you don't want to reset ''all'' files, you have some other options.
: If you installed XNB mods and want to reset one file you know is broken, you can just restore the original file. If you forgot to back it up, here's how to recover the original files without losing your modded ones:
: If you installed XNB mods and want to reset one file you know is broken, you can just restore the original file. If you forgot to back it up, here's how to recover the original files without losing your modded ones:
:# Copy your game's <code>Content</code> folder to <code>Content-modded</code>.
:# Copy your game's <code>Content</code> folder to <code>Content-modded</code>.
:# Reset your game files (see instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam] or [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy]).
:# Reset your game files (see instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam], [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy], or [https://support.xbox.com/en-US/help/games-apps/troubleshooting/troubleshoot-games-windows-10 for Xbox]).
:# Copy your (now reset) <code>Content</code> folder to <code>Content-backup</code>.
:# Copy your (now reset) <code>Content</code> folder to <code>Content-backup</code>.
:# Move <code>Content-modded</code> back to <code>Content</code>.
:# Move <code>Content-modded</code> back to <code>Content</code>.
: If you installed XNB mods, you're not sure which caused the problem, and you don't want to remove all your XNB mods, here's how to figure out which one is causing the problem.
: If you installed XNB mods, you're not sure which caused the problem, and you don't want to remove all your XNB mods, here's how to figure out which one is causing the problem.
:# Back up any XNB mods you want to keep.
:# Back up any XNB mods you want to keep.
:# Reset your game files (see instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam] or [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy]). Any XNB mods will be removed, but SMAPI mods won't be affected.
:# Reset your game files (see instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam], [https://support.gog.com/hc/en-us/articles/360003930017 for GOG Galaxy], or [https://support.xbox.com/en-US/help/games-apps/troubleshooting/troubleshoot-games-windows-10 for Xbox]). Any XNB mods will be removed, but SMAPI mods won't be affected.
:# If you use SMAPI on Linux/Mac, reinstall SMAPI to fix the launcher.
:# If you use SMAPI on Linux or macOS, reinstall SMAPI to fix the launcher.
:# 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.
<div class="modding-error-box">'''Caution:''' XNB mods (which replace your game files directly) are [[Modding:Using XNB mods|no longer recommended]] and can cause issues. Resetting your content files will remove XNB mods you installed. After doing so, consider [[Modding:Using XNB mods#Alternatives using Content Patcher|using content packs instead]].'''</div>
<div class="modding-error-box">'''Caution:''' XNB mods (which replace your game files directly) are [[Modding:Using XNB mods|no longer recommended]] and can cause issues. Resetting your content files will remove XNB mods you installed. After doing so, consider [[Modding:Using XNB mods#Alternatives using Content Patcher|using content packs instead]].'''</div>
==FAQs about Stardew Valley 1.5.5==
==<span id="dedicated-gpu">Run the game on your dedicated graphics card (Windows only)</span>==
[[File:SMAPI dedicated GPU on Windows.png|thumbnail|The 'high performance' option described in the steps on the left.]]
: You shouldn't need NET 5.0 to run Stardew Valley 1.5.5+ or SMAPI 3.13.2; Stardew bundles NET 5.0.
; What are all these weird files in my game folder?
Many computers have two options for running games: ''integrated graphics'' (part of the processor) and ''dedicated graphics'' (a separate graphics card by NVIDIA or AMD). Stardew Valley should be run on the dedicated graphics, but that's not always the default (especially on laptops). If you're not sure if this applies to your computer, it's safe to just try the instructions below anyway — they just won't do anything if it doesn't apply.
: These are from Stardew Valley 1.5.5 itself, do not delete them! (Stardew now bundles dependencies, that's what all those files are!)
To fix this:
# From the start menu, search for ''Graphics Settings'' and open it.
# In the window that opens, click "Browse" near the top and choose {{executable name|StardewModdingAPI}} in [[Modding:Player Guide/Getting Started#Find your game folder|your game folder]] (or {{executable name|Stardew Valley}} if you play without mods).
# In the app list, click "Options" under <samp>StardewModdingAPI</samp> (or <samp>Stardew Valley</samp> if you play without mods).
# Change the Graphics preference to "High performance".
# Save.
# Check whether your issues still happen.
==FAQs about Stardew Valley 1.6==
; Are mods updated for 1.6?
: Stardew Valley 1.6 is a major update, so many mods will need to be updated for it.
:* The latest [https://smapi.io/ SMAPI] and [https://www.nexusmods.com/stardewvalley/mods/1915 Content Patcher] add full support for Stardew Valley 1.6. Make sure you update SMAPI and all your mods to the latest versions.
:* 44% of SMAPI mods were ready on day one, and that number should steadily rise as they get updated. You can check the [https://smapi.io/mods/ mod compatibility list] to see if your mods are updated, or look for purple update alerts in your SMAPI console window.
:* Most content packs should work fine once the SMAPI mod which loads them is updated.
:* [[Modding:Using XNB mods|XNB mods]] are mostly broken in 1.6. These have been deprecated for years and may cause issues like broken textures, missing or broken game content, and crashes. You can [[#Reset your content files|reset your game files]] to remove any you have.
; What does 1.6 change for mods?
: Stardew Valley 1.6 has [[Modding:Migrate to Stardew Valley 1.6|a huge number of changes to help mod authors]]. For players, it has {{version|1.6|a lot of player changes}} and will also let mods do much more in the future.
; Are mods updated for 1.5.5?
; Can I go back to Stardew Valley 1.5.6 until my mods update?
: More than 95% of mods are not broken, per Pathoschild’s official stats, but some are on unofficial updates. For PyTK and TMXL, got to smapi.io/mods and search for their names there, then follow the links to the unofficial updates. For UI Info Suite, get UI Info Suite 2 from searching smapi.io/mods for the link, then going to the sidebar on Github for releases. For Content Patcher, make sure you have the most recent version. For all other mods, check smapi.io/mods for the latest version, which may be an an unofficial update.
: Yep. If you use Steam:
:# Click ''Stardew Valley'' in the Steam client.
:# Hit the cog button in the top-right corner and click the ''Properties'' option.
:# Go to the ''Betas'' tab.
:# Select "legacy_1.5.6" in the Beta Participation dropdown.
: If you use GOG:
:# Launch GOG Galaxy.
:# Click Stardew Valley.
:# From the menu at the top, click ''Extras'' to see downloads for previous versions.
=Game doesn't launch=
=Game doesn't launch=
<li>[[#Reset your content files|Reset your content files]] or reinstall the game.<li>
<li>[[#Reset your content files|Reset your content files]] or reinstall the game.<li>
<li>Delete your <code>startup_preferences</code> file. (To find it: [[Saves#Find your save files|open your saves folder]], and it'll be in the folder that contains it.)</li>
<li>Delete your <code>startup_preferences</code> file. (To find it: [[Saves#Find your save files|open your saves folder]], and it'll be in the folder that contains it.)</li>
<li>Install the software for your graphics card ([https://www.nvidia.com/en-us/geforce/geforce-experience/ GeForce Experience] for NVIDIA or [https://www.amd.com/en/technologies/radeon-software Radeon Software] for AMD), then use that software to update to your latest graphics drivers. (See [https://www.tomsguide.com/how-to/what-graphics-card-do-i-have-heres-how-to-tell how to check which graphics card you have].)</li>
<li>Install the software for your graphics card ([https://www.nvidia.com/en-us/geforce/geforce-experience/ GeForce Experience] for NVIDIA or [https://www.amd.com/en/technologies/software AMD Software] for AMD), then use that software to update to your latest graphics drivers. (See [https://www.tomsguide.com/how-to/what-graphics-card-do-i-have-heres-how-to-tell how to check which graphics card you have].)</li>
<li>Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).</li>
<li>Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).</li>
<li>Delete <code>startup_preferences</code> This can be found on Windows at %appdata% > Stardew Valley > it's in that folder, or C:\Users\Yourwindowsnamehere\AppData\Roaming\StardewValley or for Mac can be found at ~/.config/StardewValley </li>
<li>Delete <code>startup_preferences</code> This can be found on Windows at %appdata% > Stardew Valley > it's in that folder, or C:\Users\Yourwindowsnamehere\AppData\Roaming\StardewValley or for Mac can be found at ~/.config/StardewValley </li>
<dt>2. (''Windows only'') Run the game on your dedicated graphics card:</dt>
<dt>2. (''Windows only'') Run the game on your dedicated graphics card:</dt>
<dd>[[File:SMAPI dedicated GPU on Windows.png|thumbnail|The 'high performance' option described in the steps on the left.]]
<dd>See [[#dedicated-gpu|''Run the game on your dedicated graphics card (Windows only)'']] above. Don't skip this step! It very often fixes the issue.</dd>
</dd>
<dt>3. Check if there's an error message:</dt>
<dt>3. Check if there's an error message:</dt>
<dt>1. Update your graphics drivers:</dt>
<dt>1. Update your graphics drivers:</dt>
<dd><ol>
<dd><ol>
<li>Install the app for your graphics card ([https://www.nvidia.com/en-us/geforce/geforce-experience/ GeForce Experience] for NVIDIA or [https://www.amd.com/en/technologies/radeon-software Radeon Software] for AMD). If you're not sure, see [https://www.tomsguide.com/how-to/what-graphics-card-do-i-have-heres-how-to-tell how to check which graphics card you have].</li>
<li>Install the app for your graphics card ([https://www.nvidia.com/en-us/geforce/geforce-experience/ GeForce Experience] for NVIDIA or [https://www.amd.com/en/technologies/software AMD Software] for AMD). If you're not sure, see [https://www.tomsguide.com/how-to/what-graphics-card-do-i-have-heres-how-to-tell how to check which graphics card you have].</li>
<li>Open the app.</li>
<li>Open the app.</li>
<li>Find the section that shows graphics driver info. Make sure it says you have the latest version, and install any updates if not.</li>
<li>Find the section that shows graphics driver info. Make sure it says you have the latest version, and install any updates if not.</li>
<dt>2. (''Windows only'') Run the game on your dedicated graphics card:</dt>
<dt>2. (''Windows only'') Run the game on your dedicated graphics card:</dt>
<dd>[[File:SMAPI dedicated GPU on Windows.png|thumbnail|The 'high performance' option described in the steps on the left.]]
<dd>See [[#dedicated-gpu|''Run the game on your dedicated graphics card (Windows only)'']] above. Don't skip this step! It very often fixes the issue.</dd>
</dd>
<dt>3. Use the compatibility branch or an older version of Stardew Valley:</dt>
<dt>3. Use the compatibility branch or an older version of Stardew Valley:</dt>
==<samp>OutOfMemoryException</samp> errors==
==<samp>OutOfMemoryException</samp> errors==
Your log shows <samp>OutOfMemoryException</samp> errors in the console, and the game may severely lag or crash. That means your game ran out of available memory mid-session.
Your log shows <samp>OutOfMemoryException</samp> errors in the console, and the game may severely lag or crash. That means your game ran out of available memory mid-session.
This might also show up as <samp>Unable to allocate pixels for the bitmap</samp>.
Some common fixes:
Some common fixes:
* '''An antivirus hampering SMAPI in loading up the game.''' Often this results in larger gaps of time than is usual in the log (several seconds to do a very basic task). You can try disabling your antivirus to check if this is the cause, and if that fixes it, re-enabling the antivirus while whitelisting SMAPI, Stardew Valley, and the game folder.
* '''An antivirus hampering SMAPI in loading up the game.''' Often this results in larger gaps of time than is usual in the log (several seconds to do a very basic task). You can try disabling your antivirus to check if this is the cause, and if that fixes it, re-enabling the antivirus while whitelisting SMAPI, Stardew Valley, and the game folder.
** One tip: If you aren't sure if you have an antivirus, Windows has a built-in one named Windows Defender.
** One tip: If you aren't sure if you have an antivirus, Windows has a built-in one named Windows Defender.
* (Windows only) '''If you have a dedicated graphics card, run the game on it''' and not on the integrated graphics card. See above under “Game doesn’t launch” for instructions.
* (Windows only) '''If you have a dedicated graphics card, run the game on it''' and not on the integrated graphics card. See [[#dedicated-gpu|''Run the game on your dedicated graphics card (Windows only)'']] above for instructions.
* '''If you have a lot of mods, you should expect a loading time measured in minutes.''' The exact loading up time depends heavily on which exact mods you have and what your computer is like. If you have a few very large mods (such as one or more expansion-type mods) you should probably wait a few minutes before deciding something is wrong. If you have PyTK installed but are no longer using it, try removing it to see if this helps the load times.
* '''If you have a lot of mods, you should expect a loading time measured in minutes.''' The exact loading up time depends heavily on which exact mods you have and what your computer is like. If you have a few very large mods (such as one or more expansion-type mods) you should probably wait a few minutes before deciding something is wrong. If you have PyTK installed but are no longer using it, try removing it to see if this helps the load times.
==NoAudioHardwareException: Audio has failed to initialize==
==NoAudioHardwareException: Audio has failed to initialize==
This exception means that for whatever reason, either the game or SMAPI cannot use your computer's audio. A possible fix (for Windows) is installing [https://www.openal.org/downloads/ OpenAl]. You can also try plugging in some headphones or connecting a bluetooth headset.
This exception means that for whatever reason, either the game or SMAPI cannot use your computer's audio. A possible fix (for Windows) is installing [https://www.openal.org/downloads/ OpenAl]. You can also try plugging in some headphones or connecting a bluetooth headset.
==Mac: Contents/MacOS/StardewValley Already Exists==
This error looks something like:
"An error occurred in the base update loop: IOException: The file '/Users/USERNAME/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS/StardewValley' already exists."
If this happens, verify the following:
* Show hidden files in Finder with <code>Command+Shift+.</code>, then go to your home directory (named after your username, likely has a little home icon next to it on the left side of Finder). There should be a bunch of hidden folders that show up.
* The folder <code>~/.config/StardewValley/ErrorLogs</code> exists. If it doesn't exist, make it exist.
* Your screenshots button works. If it doesn't work, make sure the folder <code>~/.local/share/StardewValley/Screenshots</code> exists. If it doesn't exist, make it exist.
If neither of those fixes works, it's not clear what to do.
=Other issues=
=Other issues=
## Make sure there's no repeating errors in the SMAPI console window (if there are, see [[#Get help|''get help'']]).
## Make sure there's no repeating errors in the SMAPI console window (if there are, see [[#Get help|''get help'']]).
## Temporarily remove all mods except SMAPI and Error Handler. If that fixes it, one of your mods might be causing lag. (You can still try the other fixes below to see if they help.)
## Temporarily remove all mods except SMAPI and Error Handler. If that fixes it, one of your mods might be causing lag. (You can still try the other fixes below to see if they help.)
# For Windows players only, [[#Game doesn't launch|run the game on your dedicated graphics card]] (see subsection 2).
# For Windows players only:
## [[#dedicated-gpu|Run the game on your dedicated graphics card]].
## Install the software for your graphics card ([https://www.nvidia.com/en-us/geforce/geforce-experience/ GeForce Experience] for NVIDIA or [https://www.amd.com/en/technologies/software AMD Software] for AMD), then use that software to update to your latest graphics drivers. (See [https://www.tomsguide.com/how-to/what-graphics-card-do-i-have-heres-how-to-tell how to check which graphics card you have].)
## If using NVIDIA GeForce Experience, make sure WhisperMode is disabled.
# For Linux/SteamDeck players:
## From [[Modding:Game folder|your game folder]], open <samp>smapi-internal/config.json</samp> and set <samp>ListenForConsoleInput</samp> to false. (Note the instructions at the top of that file about creating a <samp>config.user.json</samp> file.)
# Add an exception in your antivirus software for the [[Modding:Player Guide/Getting Started#Find your game folder|Stardew Valley folder]]. You can search online for your antivirus name with the words ''add folder exception'' for instructions.<br />'''Note for Windows players:''' if didn't install an antivirus, you have Windows Defender by default and it ''can'' cause lag. Try [https://support.microsoft.com/en-us/windows/add-an-exclusion-to-windows-security-811816c0-4dfd-af4a-47e4-c301afe13b26 excluding the game folder] in that case.
# Add an exception in your antivirus software for the [[Modding:Player Guide/Getting Started#Find your game folder|Stardew Valley folder]]. You can search online for your antivirus name with the words ''add folder exception'' for instructions.<br />'''Note for Windows players:''' if didn't install an antivirus, you have Windows Defender by default and it ''can'' cause lag. Try [https://support.microsoft.com/en-us/windows/add-an-exclusion-to-windows-security-811816c0-4dfd-af4a-47e4-c301afe13b26 excluding the game folder] in that case.
# [https://www.thewindowsclub.com/processor-affinity-windows Set the processor affinity] for {{executable name|StardewModdingAPI}} (if using mods) or {{executable name|Stardew Valley}} (without mods) to 2 or higher.
# [https://www.thewindowsclub.com/processor-affinity-windows Set the processor affinity] for {{executable name|StardewModdingAPI}} (if using mods) or {{executable name|Stardew Valley}} (without mods) to 2 or higher.
For console players, please try all of the steps that apply (particularly the first four under 'check your game setup') and try [https://edu.gcfglobal.org/en/basic-computer-skills/how-to-power-cycle-a-device/1/ power cycling] your console. Please note that all consoles require their paid online service to play over the internet.
For console players, please try all of the steps that apply (particularly the first four under 'check your game setup') and try [https://edu.gcfglobal.org/en/basic-computer-skills/how-to-power-cycle-a-device/1/ power cycling] your console. Please note that all consoles require their paid online service to play over the internet.
==SMAPI files disappear or antivirus complains<span id="antivirus"></span>==
==SMAPI or mod files disappear, or they're blocked by your antivirus or browser<span id="antivirus"></span><span id="SMAPI_files_disappear_or_antivirus_complains"></span>==
Your antivirus might remove or report SMAPI/mod files. This is almost always a false positive, meaning the files don't contain a trojan.
Your antivirus or browser might delete, block, or report SMAPI or mod files. This is almost always a false positive, meaning the files don't contain a trojan.
:; '''How can I know if it's actually safe?'''
:; '''How can I know if it's actually safe?'''
:: Nothing on the Internet is guaranteed, but SMAPI itself is most likely safe — you can check by {{github|Pathoschild/SMAPI|reading the code}}, [https://www.jetbrains.com/decompiler/ decompiling the download], or [https://www.virustotal.com/ uploading it to VirusTotal]. (VirusTotal scans the file with sixty or so antiviruses; if only one or two detect an issue, it's most likely a false positive.)
:: Nothing on the Internet is guaranteed, but it's most likely safe — you can check by reading the code (e.g. see {{github|Pathoschild/SMAPI|SMAPI's code}}), [https://www.jetbrains.com/decompiler/ decompiling the download], or [https://www.virustotal.com/ uploading it to VirusTotal]. VirusTotal scans the file with sixty or so antiviruses; if only one or two detect an issue, it's most likely a false positive. Note that all files on Nexus Mods are scanned by VirusTotal automatically before they're available to download.
:; '''Why does this happen?'''
:; '''Why does this happen?'''
:: Antiviruses are usually concerned because...
:: Antiviruses and browsers are usually concerned because...
::* The download is still new. In this case it didn't really detect anything, it's just worried because it's an unknown file. Antiviruses often show a fake trojan name like <samp>Trojan:Win32/Emali.A!cl</samp> for this. Antiviruses learn to allow it after enough users download it, but that resets for each release.
::* The download is still new. In this case it didn't really detect anything, it's just worried because it's an unknown file. Antiviruses often show a fake trojan name like <samp>Trojan:Win32/Emali.A!cl</samp> for this. Antiviruses learn to allow it after enough users download it, but that resets for each release.
::* Antiviruses may check for certain patterns like accessing files or rewriting code, which are both things SMAPI mods do as part of their normal functionality (since changing the game is the whole point).
::* Antiviruses may check for certain patterns like accessing files or rewriting code, which are both things SMAPI mods do as part of their normal functionality (since changing the game is the whole point).
:; '''How can I install SMAPI or the mod if my antivirus flags it?'''
:; '''How can I download a file which my browser blocks as 'suspicious'?'''
:: There are two approaches:
::* You can wait a few days before downloading a new update (or a few weeks for a less popular mod). Once enough users have downloaded it, your browser won't considers it an unknown file anymore.
::* ''Or'' the browser UI which says the file is supicious should have a 'more info' link, or a symbol like '''⋮''' or '''▼''' which indicates options. Click that to show the option to download it anyway.
::* One option is to just wait a few days before downloading a new update (or a few weeks for a less popular mod). By then enough users should have downloaded it to reduce antivirus alerts.
:; '''How can I install SMAPI or a mod if my antivirus flags it?'''
::* If you've checked that it's safe above, another option is to...
:: There are two approaches:
::* You can wait few days before downloading a new update (or a few weeks for a less popular mod). By then enough users should have downloaded it to reduce antivirus alerts.
::* ''Or'' if you've checked that it's safe above, another option is to...
::*# Temporarily disable your antivirus.
::*# Temporarily disable your antivirus.
::*# Redownload and [[Modding:Player Guide/Getting Started#Getting started|install SMAPI]] or the mod.
::*# Redownload and [[Modding:Player Guide/Getting Started#Getting started|install SMAPI]] or the mod.
Common fixes:
Common fixes:
# Launch the game through Steam.
# Launch the game through Steam.
# Windows only: make sure you set the launch options (see [[Modding:Installing SMAPI on Windows#Configure your game client|''Configure your game client'' in the Windows install guide]]), don't add SMAPI as a non-Steam game.
# Windows only: make sure you set the launch options (see [[Modding:Installing SMAPI on Windows#Configure your game client|''Configure your game client'' in the Windows install guide]]).
# If all else fails, you can use third-party software to add controller support. Suggested software:
# If all else fails, you can use third-party software to add controller support. Suggested software:
#* Linux: {{github|kozec/sc-controller|SC Controller}}.
#* Linux: {{github|kozec/sc-controller|SC Controller}}.
If you want to rollback to Stardew Valley 1.5.4, here's how:
If you want to rollback to Stardew Valley 1.5.4, here's how:
:Please note this only works on the '''Steam''' version of the game!
# Install [https://dotnet.microsoft.com/download/dotnet .NET 5 or later].
# Install [https://dotnet.microsoft.com/download/dotnet .NET 5 or later].
</li>
</li>
<li><p>''Or'' use a tool called DepotDLGUI designed to download 1.5.4 more easily using [{{github|SteamRE/DepotDownloader}} DepotDownloader].</p>
<li><p>''Or'' use a tool called DepotDLGUI designed to download 1.5.4 more easily using [{{github|SteamRE/DepotDownloader}} DepotDownloader].</p>
:Please note this only works on the '''Steam''' version of the game!
# Install [https://dotnet.microsoft.com/en-us/download/dotnet/5.0 .NET 5].
# Install [https://dotnet.microsoft.com/en-us/download/dotnet/5.0 .NET 5].
# Download the latest release of [{{github|AnotherPillow/StardewValley_DepotDLGUI}} DepotDLGui]. (Green Price Tag on the right side of the screen, under the word Releases)
# Download the latest release of [{{github|AnotherPillow/StardewValley_DepotDLGUI}} DepotDLGui]. (Green Price Tag on the right side of the screen, under the word Releases)
|next = [[Modding:Mod compatibility|Compatibility]]
|next = [[Modding:Mod compatibility|Compatibility]]
}}
}}
[[Category:Modding]]
[[de:Modding:Spieleranleitung/Problembehebung]]
[[de:Modding:Spieleranleitung/Problembehebung]]
[[es:Modding:Guía del jugador/Solución de problemas]]
[[es:Modding:Guía del jugador/Solución de problemas]]
[[zh:模组:使用指南/疑难解答]]
[[zh:模组:使用指南/疑难解答]]