add friendly error for NoSuitableGraphicsDeviceException

Author: Pathoschild

docs/release-notes.md

@@ -1,6 +1,10 @@
 ← [README](README.md)
 
 # Release notes
+## Upcoming release
+* For players:
+  * Added a friendly error message when the game fails to launch with a `NoSuitableGraphicsDeviceException`.
+
 ## 4.3.1
 Released 13 July 2025 for Stardew Valley 1.6.14 or later. See [release highlights](https://www.patreon.com/posts/133992196).
 

src/SMAPI/Framework/SCore.cs

@@ -319,6 +319,17 @@ public void RunInteractively()
             this.Game.Run();
             this.Dispose(isError: false);
         }
+        catch (NoSuitableGraphicsDeviceException ex)
+        {
+            string? graphicsCardName = this.TryGetGraphicsDeviceName();
+            string suggestedFix = Constants.TargetPlatform == GamePlatform.Windows
+                ? "You can usually fix this by running SMAPI on your dedicated graphics card. See instructions here:"
+                : "See common fixes here:";
+
+            this.Monitor.Log($"Your graphics card{(graphicsCardName != null ? $" ({graphicsCardName})" : "")} isn't compatible with Stardew Valley. {suggestedFix} https://smapi.io/troubleshoot/no-suitable-gpu\n\nTechnical details:\n{ex.GetLogSummary()}", LogLevel.Error);
+            this.LogManager.PressAnyKeyToExit();
+            this.Dispose(isError: true);
+        }
         catch (Exception ex)
         {
             this.LogManager.LogFatalLaunchError(ex);
@@ -525,7 +536,7 @@ private void OnInstanceContentLoaded()
 
         // log GPU info
 #if SMAPI_FOR_WINDOWS
-        this.Monitor.Log($"Running on GPU: {Game1.game1.GraphicsDevice?.Adapter?.Description ?? "<unknown>"}");
+        this.Monitor.Log($"Running on GPU: {this.TryGetGraphicsDeviceName() ?? "<unknown>"}");
 #endif
     }
 
@@ -2440,6 +2451,23 @@ private IDictionary<string, IDictionary<string, string>> ReadTranslationFiles(st
         }
     }
 
+    /// <summary>Get the display name for the current graphics card, if available.</summary>
+    private string? TryGetGraphicsDeviceName()
+    {
+#if SMAPI_FOR_WINDOWS
+        try
+        {
+            return Game1.game1.GraphicsDevice?.Adapter?.Description;
+        }
+        catch
+        {
+            // return null if unavailable
+        }
+#endif
+
+        return null;
+    }
+
     /// <summary>Get a file lookup for the given directory.</summary>
     /// <param name="rootDirectory">The root path to scan.</param>
     private IFileLookup GetFileLookup(string rootDirectory)