add friendly error when game can't load audio (#472)

2 files changed, 7 insertions, 0 deletions

diff --git a/docs/release-notes.md b/docs/release-notes.md
index 6842c941..86475d6e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -3,6 +3,7 @@
 * For players:
   * Added support for Stardew Valley 1.3+; no longer compatible with earlier versions.
   * Added warning for mods which don't have update checks configured.
+  * Added friendly error when game can't start audio.
   * Fixed detection of GOG install path in rare cases.
   * Fixed SMAPI update checks not showing newer beta versions when using a beta version.
   * Fixed console color scheme on Mac or PowerShell, and added override option to `StardewModdingAPI.config.json`.
diff --git a/src/SMAPI/Program.cs b/src/SMAPI/Program.cs
index f1152d82..eda85866 100644
--- a/src/SMAPI/Program.cs
+++ b/src/SMAPI/Program.cs
@@ -259,6 +259,12 @@ namespace StardewModdingAPI
                 StardewValley.Program.releaseBuild = true; // game's debug logic interferes with SMAPI opening the game window
                 this.GameInstance.Run();
             }
+            catch (InvalidOperationException ex) when (ex.Source == "Microsoft.Xna.Framework.Xact" && ex.StackTrace.Contains("Microsoft.Xna.Framework.Audio.AudioEngine..ctor"))
+            {
+                this.Monitor.Log("The game couldn't load audio. Do you have speakers or headphones plugged in?", LogLevel.Error);
+                this.Monitor.Log($"Technical details: {ex.GetLogSummary()}", LogLevel.Trace);
+                this.PressAnyKeyToExit();
+            }
             catch (Exception ex)
             {
                 this.Monitor.Log($"The game failed unexpectedly: {ex.GetLogSummary()}", LogLevel.Error);