translators
8,445
edits
Changes
Jump to navigation
Jump to search
Line 36:
Line 36: − + − ==="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== Line 97:
Line 66: − + Line 150:
Line 119: − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Modding:Player Guide/Troubleshooting (view source)
Revision as of 18:43, 3 February 2019
, 18:43, 3 February 2019reorganise page to present common issues first
<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==
===Save disappeared or doesn't load===
===Save disappeared or doesn't load===
See [[Saves#Troubleshooting]].
See [[Saves#Troubleshooting]].
# 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.
* 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]].