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