Changes

Jump to navigation Jump to search
reorganise page to present common issues first
Line 36: Line 36:  
<div style="border: 1px solid red; background: #FCC; padding: 1em;">'''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. See [[#Alternatives using Content Patcher|alternatives using Content Patcher]].'''</div>
 
<div style="border: 1px solid red; background: #FCC; padding: 1em;">'''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. See [[#Alternatives using Content Patcher|alternatives using Content Patcher]].'''</div>
   −
==Fix common error messages==
+
==Fix common problems==
==="SMAPI can't find the game"===
  −
* Make sure you're running <code>StardewModdingAPI.exe</code> in your game folder (see the [[Modding:Player Guide/Getting Started#Getting started|install instructions]]).
  −
* Did you install SMAPI manually (not [[Modding:Player Guide/Getting Started#Install SMAPI|using the installer]])? Make sure you copied the right files: <code>internal/Windows</code> for Windows, or <code>internal/Mono</code> for Linux/Mac.
  −
 
  −
==="Skipped '...' because it doesn't have a manifest.json"===
  −
SMAPI couldn't find the <code>manifest.json</code> file for the mod in that folder. That usually means it's not a SMAPI mod, so it won't work from the <code>Mods</code> folder. See that mod's documentation for install instructions.
  −
 
  −
===Steam: "missing executable"===
  −
Steam can't find the game launcher, usually because your Steam launch options are incorrect. Common fixes:
  −
 
  −
* If you want to use SMAPI:<br />make sure it's installed and your launch options are correct (see [[Modding:Player Guide/Getting Started#Getting started|install guide]]).
  −
* If you're uninstalling SMAPI:<br />
  −
*# In Steam, right-click ''Stardew Valley'' and choose ''Properties''.
  −
*# Click the ''Set Launch Options'' button.
  −
*# Make sure the textbox is completely empty.
  −
 
  −
===Linux/Mac: "looks like Mono isn't installed"===
  −
Mono is a framework needed by the installer and SMAPI to work correctly. Installing [http://mono-project.com/ Mono] and restarting your computer usually fixes this error.
  −
 
  −
On Mac, it might not work after installing Mono. If so:
  −
* Enter this command: <source>ln -s /Library/Frameworks/Mono.framework/Versions/Current/bin/mono /usr/local/bin/mono</source>
  −
* If that shows an error or it still doesn't work, you can [https://brew.sh install Homebrew] and run <code>brew install mono mono-libgdiplus</code> in the Terminal app.
  −
 
  −
===Windows: "BadImageFormatException: Could not load file or assembly 'Microsoft.Xna.*.dll'"===
  −
That means something is wrong with your copy of XNA Framework. Unfortunately that can be hard to fix since it's integrated into Windows now. The most reliable solutions are...
  −
 
  −
# Reinstall XNA Framework (see [[#Steam: nothing happens when you launch game (Windows only)|''Steam: nothing happens when you launch game (Windows only)'']] for instructions).
  −
# [https://support.microsoft.com/en-us/help/4026528/windows-reset-or-reinstall-windows-10 Perform a Windows reset] (you can keep your files).
  −
# Perform a clean reinstall of Windows. This is drastic, but usually fixes the issue.
  −
 
  −
==Fix other issues==
   
===Save disappeared or doesn't load===
 
===Save disappeared or doesn't load===
 
See [[Saves#Troubleshooting]].
 
See [[Saves#Troubleshooting]].
Line 97: Line 66:  
# Add an exception to your antivirus for the [[Modding:Player Guide/Getting Started#Find your game_folder|Stardew Valley folder]] (search online for your antivirus name with the words ''add folder exception'' for instructions).
 
# Add an exception to your antivirus for the [[Modding:Player Guide/Getting Started#Find your game_folder|Stardew Valley folder]] (search online for your antivirus name with the words ''add folder exception'' for instructions).
   −
===Steam: controller doesn't work properly===
+
===Controller doesn't work properly with SMAPI (Steam only)===
 
Common fixes:
 
Common fixes:
 
# Launch the game through Steam.
 
# Launch the game through Steam.
Line 150: Line 119:  
* If that doesn't fix it: right-click on <tt>Stardew Valley.exe</tt> and go to ''Properties > Compatibility > Change high DPI settings''. Take note of what options are set (even if they're grayed out), then set the same options for <tt>StardewModdingAPI.exe</tt>.
 
* If that doesn't fix it: right-click on <tt>Stardew Valley.exe</tt> and go to ''Properties > Compatibility > Change high DPI settings''. Take note of what options are set (even if they're grayed out), then set the same options for <tt>StardewModdingAPI.exe</tt>.
   −
===Other problems===
+
==Fix specific errors==
 +
==="SMAPI can't find the game"===
 +
* Make sure you're running <code>StardewModdingAPI.exe</code> in your game folder (see the [[Modding:Player Guide/Getting Started#Getting started|install instructions]]).
 +
* Did you install SMAPI manually (not [[Modding:Player Guide/Getting Started#Install SMAPI|using the installer]])? Make sure you copied the right files: <code>internal/Windows</code> for Windows, or <code>internal/Mono</code> for Linux/Mac.
 +
 
 +
==="Skipped '...' because it doesn't have a manifest.json"===
 +
SMAPI couldn't find the <code>manifest.json</code> file for the mod in that folder. That usually means it's not a SMAPI mod, so it won't work from the <code>Mods</code> folder. See that mod's documentation for install instructions.
 +
 
 +
==="missing executable" (Steam only)===
 +
Steam can't find the game launcher, usually because your Steam launch options are incorrect. Common fixes:
 +
 
 +
* If you want to use SMAPI:<br />make sure it's installed and your launch options are correct (see [[Modding:Player Guide/Getting Started#Getting started|install guide]]).
 +
* If you're uninstalling SMAPI:<br />
 +
*# In Steam, right-click ''Stardew Valley'' and choose ''Properties''.
 +
*# Click the ''Set Launch Options'' button.
 +
*# Make sure the textbox is completely empty.
 +
 
 +
==="looks like Mono isn't installed" (Linux/Mac only)===
 +
Mono is a framework needed by the installer and SMAPI to work correctly. Installing [http://mono-project.com/ Mono] and restarting your computer usually fixes this error.
 +
 
 +
On Mac, it might not work after installing Mono. If so:
 +
* Enter this command: <source>ln -s /Library/Frameworks/Mono.framework/Versions/Current/bin/mono /usr/local/bin/mono</source>
 +
* If that shows an error or it still doesn't work, you can [https://brew.sh install Homebrew] and run <code>brew install mono mono-libgdiplus</code> in the Terminal app.
 +
 
 +
==="BadImageFormatException: Could not load file or assembly 'Microsoft.Xna.*.dll'" (Windows only)===
 +
That means something is wrong with your copy of XNA Framework. Unfortunately that can be hard to fix since it's integrated into Windows now. The most reliable solutions are...
 +
 
 +
# Reinstall XNA Framework (see [[#Steam: nothing happens when you launch game (Windows only)|''Steam: nothing happens when you launch game (Windows only)'']] for instructions).
 +
# [https://support.microsoft.com/en-us/help/4026528/windows-reset-or-reinstall-windows-10 Perform a Windows reset] (you can keep your files).
 +
# Perform a clean reinstall of Windows. This is drastic, but usually fixes the issue.
 +
 
 +
==Fix other problems==
 
Run the game without SMAPI by launching <code>Stardew Valley.exe</code> (on Windows) or <code>StardewValley-original</code> (on Linux/Mac) in your [[Modding:Player Guide/Getting Started#Find your game folder|game folder]].
 
Run the game without SMAPI by launching <code>Stardew Valley.exe</code> (on Windows) or <code>StardewValley-original</code> (on Linux/Mac) in your [[Modding:Player Guide/Getting Started#Find your game folder|game folder]].
  
translators
8,441

edits

Navigation menu