Changes

Jump to navigation Jump to search
merge and expand game-doesn't-launch sections
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>
translators
8,438

edits

Navigation menu