Line 58: |
Line 58: |
| | | |
| <h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;">Game doesn't launch</h1> | | <h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;">Game doesn't launch</h1> |
− | ==Nothing happens when you launch the game==
| |
| When you try to launch the game, nothing seems to happen or the window closes instantly. (If you use Steam, it might show 'running' for a few seconds.) | | When you try to launch the game, nothing seems to happen or the window closes instantly. (If you use Steam, it might show 'running' for a few seconds.) |
| | | |
− | Here are some common fixes:
| + | <ol> |
− | | + | <li>First, try these common fixes: |
| <ol> | | <ol> |
| <li>Restart your computer.</li> | | <li>Restart your computer.</li> |
| <li><p>Make sure you have speakers or headphones plugged in. They can be muted, but the game needs a working audio device. (Without audio devices, you may see an error like "''Microsoft.XNA.Framework.Audio.NoAudioHardwareExcpetion....Audio has failed to initialize''".)</p></li> | | <li><p>Make sure you have speakers or headphones plugged in. They can be muted, but the game needs a working audio device. (Without audio devices, you may see an error like "''Microsoft.XNA.Framework.Audio.NoAudioHardwareExcpetion....Audio has failed to initialize''".)</p></li> |
− | <li>[[Modding:Player_Guide/Troubleshooting#Reset_your_content_files|Reset 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>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>Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).</li> |
| <li>If you play on... | | <li>If you play on... |
| {| class="wikitable" | | {| class="wikitable" |
Line 83: |
Line 85: |
| |} | | |} |
| </li> | | </li> |
− | <li>If that doesn't fix it: | + | <li>If you use SMAPI with Steam, double-check your Steam launch options. For Windows, see [[Modding:Installing SMAPI on Windows#Steam|the Steam instructions]]). For other platforms, make sure the launch options are empty.</li> |
− | # [[Modding:Installing SMAPI on Windows|Install SMAPI]] (if you don't already have it).
| + | </ol></li> |
− | # Launch the game.
| |
− | # [[#Ask for help|Ask for help and attach your SMAPI log]].
| |
− | </li> | |
− | </ol> | |
| | | |
− | ==Game freezes or crashes while launching (without SMAPI installed)==
| + | <li>If it still happens, check if there's an error message next: |
− | The game tries to open, but crashes before the title screen. Here are some common fixes:
| + | <ol> |
− | # Try everything in the list above first.
| + | <li>[[Modding:Game folder|Open your game folder]].</li> |
− | # Delete your <code>startup_preferences</code>, found in <code>%appdata%/StardewValley</code> on Windows.
| + | <li>Hold {{key|Shift}} and right-click the folder background.</li> |
− | # Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).
| + | <li>Click the option that says ''Open in Command Prompt'', ''Open in PowerShell'', or ''Open in Windows Terminal'' (depending on your system settings).</li> |
− | # Follow the steps to [[#Ask for help|ask for help]].
| + | <li>Type this command: |
| + | {| class="wikitable" |
| + | |- |
| + | ! if you play... |
| + | ! command |
| + | |- |
| + | | with mods |
| + | | <code>.\StardewModdingAPI.exe</code> |
| + | |- |
| + | | without mods |
| + | | <code>.\"Stardew Valley.exe"</code> |
| + | |}</li> |
| + | <li>Press enter to run the command.</li> |
| + | <li>If it shows an error message, check for a section under [[#Specific error messages|''Specific error messages'']] below.</li> |
| + | </ol></li> |
| | | |
− | ==Game freezes or crashes while launching (with SMAPI installed)==
| + | <li>If you still haven't solved it, come [[#Ask for help|Ask for help]]!</li> |
− | The game tries to open, but crashes before the title screen. Here are some common fixes:
| + | </ol> |
− | # Try everything in the list under [[Modding:Player_Guide/Troubleshooting#Game_doesn.27t_launch]] first.
| |
− | # If you're on Windows, reset your Steam launch settings (instructions here: [[Modding:Installing_SMAPI_on_Windows#Steam]]). If you're not on Windows, you can check to make sure that they're blank.
| |
− | # Delete your <code>startup_preferences</code>, found in <code>%appdata%/StardewValley</code> on Windows.
| |
− | # Disable antivirus.
| |
− | # Disable any programs that intercept the game (like MSI AfterBurner or RivaTuner).
| |
− | # Make sure the drivers for your graphics cards are up-to-date.
| |
− | # If that doesn't fix it:
| |
− | ## Open the game folder. (You can find it on Steam by right clicking on the game name, looking under Manage, and clicking "Browse Local Files".)
| |
− | ## Hold shift and right-click on the folder background.
| |
− | ## Click the option that says Open in command prompt / PowerShell / Windows Terminal (depending on your Windows settings).
| |
− | ## Run <code>StardewModdingAPI.exe</code> (if Command Prompt) or <code>./StardewModdingAPI.exe</code> (if PowerShell or Windows Terminal).
| |
− | ## Now if it crashes, the window should stay open so you can see the error. Check the error against the [[Modding:Player_Guide/Troubleshooting#Fix_specific_errors|specific errors list below]].
| |
− | ## If that doesn't help, post a screenshot of the full window when it shows the error in the #using-mods discord channel for debugging help.
| |
− | # Follow the steps to [[#Ask for help|ask for help]].
| |
| | | |
| <h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;">Specific error messages</h1> | | <h1 style="margin-top: 3em; border: 2px solid rgb(0, 116, 72); background: rgba(3, 160, 7, 0.1); padding: 1em;">Specific error messages</h1> |